Docker 常见故障排查与调试

1. 容器无法启动

• docker ps -a 查看容器状态。
• docker logs <container> 检查启动日志。
• docker inspect <container> 查看 State 和 Mounts。

2. 容器命令执行错误

docker exec -it <container> /bin/sh

• 使用正确 Shell（bash 或 sh）。
• 检查工作目录、环境变量和可执行文件路径。

3. 网络无法互通

• 确认容器在同一自定义网络。
• docker network inspect <network> 查看连接容器。
• 使用 curl、ping 或 nc 在容器内测试。

4. 端口映射问题

• 检查 docker ps 中 PORTS 映射。
• 确认宿主机端口未被其它进程占用。
• 使用 ss -lntp 或 lsof -i 检查。

5. 镜像构建失败

• 检查 Dockerfile 语法与 COPY 路径。
• 确认构建上下文是否包含目标文件。
• 使用 docker build --progress=plain 展示详细日志。

6. 性能与资源问题

• docker stats 查看 CPU/内存使用情况。
• 容器可能受限于 --cpus、--memory 或 ulimit。
• 检查宿主机资源是否已满。

7. 数据卷与文件权限

• 绑定挂载路径权限问题常见于 Linux 权限不匹配。
• docker volume inspect 查看卷来源。
• 如果文件不可写，可在容器内检查 uid:gids。

8. 彻底重置测试环境

docker compose down --volumes --remove-orphans
docker system prune -af

• 仅在测试环境使用，避免误删生产数据。