Docker 容器启动后立即退出 Exit Code 非零怎么排查？

Question

仓乃文 · Accepted Answer

容器启动后立即退出是 Docker 初学者最常遇到的问题。容器必须有前台进程运行，PID 1 进程退出容器就会停止。排查的关键是看 Exit Code 和日志，不同 Exit Code 指向不同原因。常见 Exit Code 含义： ``` | Exit Code | 含义 | 常见原因 | |-----------|---------------------|------------------------------| | 0 | 正常退出 | 容器任务执行完毕（如一次性脚本） | | 1 | 应用错误 | 代码异常、配置错误 | | 137 | 被 SIGKILL 杀死 | OOM（内存不足）被系统杀掉 | | 139 | 段错误 Segfault | 程序崩溃、内存越界 | | 143 | 被 SIGTERM 终止 | docker stop 正常停止 | | 125 | Docker 守护进程错误 | docker run 参数错误 | | 126 | 权限不足 | 可执行文件无执行权限 | | 127 | 命令未找到 | CMD/ENTRYPOINT 指令不存在 | ``` 排查步骤： ```bash # 1. 查看容器状态和 Exit Code docker ps -a # STATUS 列显示 Exited (137) 5 seconds ago # 137 = OOM Killed # 2. 查看容器日志（最重要） docker logs # 加 --tail 只看最后几行 docker logs --tail 50 # 3. 查看 OOM 信息 docker inspect --format "{{.State.OOMKilled}}" # true 表示被 OOM 杀掉 # 4. 查看详细信息 docker inspect # 关注 State、Config、Mounts、NetworkSettings # 5. 容器秒退时用这个技巧调试 docker run --rm -it --entrypoint /bin/sh # 手动进入容器排查 ``` 常见场景与修复： ```bash # 场景 1：CMD 执行完就退出（Exit 0） # 原因：容器没有前台进程 # 修复：确保 CMD 是常驻进程，或加 tail -f 保持运行 docker run -d nginx # nginx 默认前台运行，OK docker run -d ubuntu # ubuntu 没有前台进程，立即退出！ docker run -d ubuntu tail -f /dev/null # 保持运行 # 场景 2：配置文件路径错误（Exit 1） # 日志通常有明确错误信息："config file not found" # 修复：检查 -v 挂载路径是否正确 docker run -v /host/conf:/app/conf myapp # 场景 3：端口被占用（Exit 1） # 日志："bind: address already in use" # 修复：换端口或停掉占用进程 docker run -p 8080:80 nginx # 宿主机 8080 被占用 # 场景 4：OOM 被杀（Exit 137） # 修复：增加内存限制 docker run -m 1g myapp # 或排查内存泄漏 ``` 补充说明： - docker ps -a 显示所有容器（包括已停止的），docker ps 只显示运行中的 - 容器秒退时，docker logs 可能看不到输出，用 --entrypoint 进入容器手动执行 CMD 排查 - 规则：容器必须有前台进程（PID 1），否则立即退出 - 生产环境建议加健康检查 HEALTHCHECK，自动检测容器假死