Docker 容器启动失败问题排查指南

当 docker start 命令无法启动容器时，可以按照以下步骤进行排查和解决：

1. 查看容器日志

docker logs <container_name_or_id>

这会显示容器上次运行时的输出日志，可能包含启动失败的原因。

2. 检查容器状态

docker ps -a

查看容器的状态，确认是否是"Exited"状态以及退出代码。

3. 尝试交互式启动

docker start -ai <container_name_or_id>

-a 参数附加输出，-i 参数交互式运行，可以看到更多错误信息。

4. 检查容器配置

docker inspect <container_name_or_id>

查看容器的详细配置信息，特别是： - 挂载点是否正确 - 端口映射是否冲突 - 环境变量设置 - 启动命令是否正确

5. 常见问题及解决方案

5.1 端口冲突

Error response from daemon: driver failed programming external connectivity on endpoint...

解决方案： - 停止占用端口的其他服务 - 修改容器端口映射：docker run -p <new_host_port>:<container_port>

5.2 存储卷问题

Error response from daemon: error while mounting volume...

解决方案： - 检查挂载路径是否存在 - 确保有正确的访问权限 - 使用 docker volume inspect <volume_name> 检查卷

5.3 启动命令失败

/bin/sh: 1: <command>: not found

解决方案： - 检查容器内是否有该命令 - 修改 Dockerfile 或启动命令

5.4 资源不足

Cannot start container: [8] System error: not enough memory

解决方案： - 增加 Docker 资源分配 - 限制容器资源使用：docker run --memory=512m

6. 高级排查方法

6.1 进入容器检查

docker commit <container_id> temp-image
docker run -it --entrypoint=/bin/sh temp-image

6.2 检查 Docker 守护进程日志

journalctl -u docker.service
# 或
cat /var/log/docker.log

6.3 彻底删除并重建容器

docker rm <container_id>
docker run ... # 使用原始创建命令

7. 预防措施

1. 在 Dockerfile 中使用 HEALTHCHECK 指令
2. 为容器设置适当的资源限制
3. 使用 --restart 策略处理意外退出
4. 记录详细的容器日志

如果以上方法仍无法解决问题，请提供具体的错误信息以便进一步分析。