容器与云原生 / 系统课时

排查容器启动后立即退出

排查容器启动后立即退出

本课解决“容器创建成功却马上停止”的问题。你将从容器主进程、启动命令、退出码和日志按固定顺序定位原因,并判断应修改镜像、启动参数还是应用配置。

学习目标

  • 理解容器生命周期与主进程退出的关系
  • 使用状态、退出码和日志快速缩小故障范围
  • 识别错误启动命令、后台运行和应用异常三类常见根因

先确认容器是否真的退出

docker ps 只显示运行中的容器,因此排查时应先查看全部容器。重点关注 STATUS、退出码和停止时间,而不是反复执行 docker start。下面创建一个会主动返回错误码的演示容器:

bash
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

预期输出

text
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 对应的主进程。主进程结束后,即使容器内曾启动其他后台进程,容器也会退出。建议按以下顺序定位:

  1. 用 docker inspect 查看 State.ExitCode、State.OOMKilled 和 State.Error。
  2. 用 docker logs --tail 100 <容器名> 查看应用最后一次输出。
  3. 查看镜像声明的 Entrypoint 与 Cmd,确认运行时参数是否覆盖了默认命令。
  4. 必要时用交互式 Shell 启动镜像,手动执行原命令并观察报错。

查看镜像启动配置的命令如下:

bash
docker image inspect alpine:3.20 --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}'

预期输出

text
entrypoint=null cmd=["/bin/sh"]

若执行 docker run alpine:3.20,Shell 没有交互输入便会结束,因此容器正常退出。这不是 Docker 故障,而是镜像默认主进程已经完成。

识别三类高频根因

第一类是启动命令写错,例如可执行文件路径不存在、参数格式错误或脚本没有执行权限。此时常见退出码为 126 或 127,日志中通常能看到 Permission denied 或 not found。

第二类是把服务放到后台。例如在容器中执行 service nginx start 后,启动脚本结束,PID 1 随即退出。容器内服务应以前台模式运行,例如 Nginx 使用:

bash
nginx -g 'daemon off;'

预期结果

text
命令保持前台运行;只要 Nginx 主进程未退出,容器就保持 running 状态。

第三类是应用自身异常,包括配置缺失、端口占用、数据库连接失败、内存不足或启动检查未通过。若 OOMKilled=true,应优先检查内存限制和应用峰值,而不是只增加重启次数。

修复后进行闭环验证

修复启动命令或配置后,重新创建容器,再连续检查状态和日志:

bash
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

预期输出

text
exit-demo
<ID>
status=running running=true

演示容器不会产生日志,因此最后一条命令可能没有输出。真实应用还应执行健康检查或业务请求,确认“容器在运行”不等于“服务可用”。

提示: --restart=always 只能让失败容器反复重启,不能修复错误命令或应用异常。应先找到退出原因,再配置合理的重启策略。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查容器启动后立即退出

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通