容器与云原生 / 系统课时
排查容器启动后立即退出
排查容器启动后立即退出
本课解决“容器创建成功却马上停止”的问题。你将从容器主进程、启动命令、退出码和日志按固定顺序定位原因,并判断应修改镜像、启动参数还是应用配置。
学习目标
- 理解容器生命周期与主进程退出的关系
- 使用状态、退出码和日志快速缩小故障范围
- 识别错误启动命令、后台运行和应用异常三类常见根因
先确认容器是否真的退出
docker ps 只显示运行中的容器,因此排查时应先查看全部容器。重点关注 STATUS、退出码和停止时间,而不是反复执行 docker start。下面创建一个会主动返回错误码的演示容器:
docker rm -f exit-demo 2>/dev/null || true
docker run --name exit-demo alpine:3.20 sh -c 'echo "application starting"; exit 1'
docker ps -a --filter name=exit-demo
docker inspect exit-demo --format 'status={{.State.Status}} exitCode={{.State.ExitCode}} error={{.State.Error}}'
docker logs exit-demo预期输出
application starting
CONTAINER ID IMAGE COMMAND CREATED STATUS NAMES
<ID> alpine:3.20 "sh -c 'echo ...'" <TIME> ago Exited (1) <TIME> ago exit-demo
status=exited exitCode=1 error=
application starting<ID> 和 <TIME> 会随实际运行环境变化。退出码 0 通常表示程序正常结束,非 0 表示程序或启动脚本报告失败;若 error 不为空,还要检查 Docker 在创建进程阶段是否失败。
按顺序检查主进程、命令和日志
容器是否持续运行,取决于 PID 1 对应的主进程。主进程结束后,即使容器内曾启动其他后台进程,容器也会退出。建议按以下顺序定位:
- 用
docker inspect查看State.ExitCode、State.OOMKilled和State.Error。 - 用
docker logs --tail 100 <容器名>查看应用最后一次输出。 - 查看镜像声明的
Entrypoint与Cmd,确认运行时参数是否覆盖了默认命令。 - 必要时用交互式 Shell 启动镜像,手动执行原命令并观察报错。
查看镜像启动配置的命令如下:
docker image inspect alpine:3.20 --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}'预期输出
entrypoint=null cmd=["/bin/sh"]若执行 docker run alpine:3.20,Shell 没有交互输入便会结束,因此容器正常退出。这不是 Docker 故障,而是镜像默认主进程已经完成。
识别三类高频根因
第一类是启动命令写错,例如可执行文件路径不存在、参数格式错误或脚本没有执行权限。此时常见退出码为 126 或 127,日志中通常能看到 Permission denied 或 not found。
第二类是把服务放到后台。例如在容器中执行 service nginx start 后,启动脚本结束,PID 1 随即退出。容器内服务应以前台模式运行,例如 Nginx 使用:
nginx -g 'daemon off;'预期结果
命令保持前台运行;只要 Nginx 主进程未退出,容器就保持 running 状态。第三类是应用自身异常,包括配置缺失、端口占用、数据库连接失败、内存不足或启动检查未通过。若 OOMKilled=true,应优先检查内存限制和应用峰值,而不是只增加重启次数。
修复后进行闭环验证
修复启动命令或配置后,重新创建容器,再连续检查状态和日志:
docker rm -f exit-demo
docker run -d --name exit-demo alpine:3.20 sh -c 'while true; do sleep 30; done'
sleep 1
docker inspect exit-demo --format 'status={{.State.Status}} running={{.State.Running}}'
docker logs --tail 20 exit-demo预期输出
exit-demo
<ID>
status=running running=true演示容器不会产生日志,因此最后一条命令可能没有输出。真实应用还应执行健康检查或业务请求,确认“容器在运行”不等于“服务可用”。
提示:
--restart=always只能让失败容器反复重启,不能修复错误命令或应用异常。应先找到退出原因,再配置合理的重启策略。