容器与云原生 / 系统课时

Exited 1 到底代表什么

Exited 1 到底代表什么

看到容器显示 Exited (1) 时,能确定的只有一件事:容器的主进程以退出码 1 结束。它并不直接说明是 Docker、镜像还是业务代码出了什么问题;定位根因仍要回到进程日志、启动命令和运行时配置。

学习目标

  • 理解 Exited (1) 与真正故障原因之间的区别。
  • 能用 docker ps、docker inspect 和 docker logs 建立最短排查路径。
  • 能区分退出码、Docker 状态字段与应用自身错误信息。

先读懂 Exited 1

Docker 容器的生命周期取决于 PID 1,也就是容器启动时执行的主进程。主进程结束,容器就停止;Exited (1) 中的 1 是这个进程返回给操作系统的退出码。

按照常见约定,0 表示成功结束,非零值表示程序报告失败。退出码只描述“怎么结束”,不描述“为什么失败”。配置文件缺失、环境变量错误、命令参数无效、连接数据库失败、应用主动自检失败,都可能最终返回 1。

Exited 1 排查路径

用最小示例观察状态

下面创建一个明确打印错误并以 1 退出的容器。示例使用 Alpine,实际首次运行时可能先拉取镜像。

bash
docker rm -f exit-demo >/dev/null 2>&1 || true
docker run --name exit-demo alpine:3.20 sh -c 'echo "config missing" >&2; exit 1'
docker ps -a --filter name=exit-demo --format '{{.Names}} {{.Status}}'
docker inspect --format 'exit={{.State.ExitCode}} oom={{.State.OOMKilled}} error={{json .State.Error}}' exit-demo
docker logs exit-demo

预期输出

text
config missing
exit-demo Exited (1) <TIME> ago
exit=1 oom=false error=""
config missing

<TIME> 会随实际执行时间变化。这里 State.Error 为空,说明 Docker 没有记录容器运行时层面的启动错误;真正的失败原因由应用日志给出,即 config missing。

按固定顺序定位根因

先确认状态,再看 Docker 记录的退出信息,最后回到应用本身。这个顺序能避免一上来就重启容器,把最有价值的首次失败现场覆盖掉。

先看 docker ps -a,确认容器是否真的以 1 退出,而不是仍在重启。再用 docker inspect 检查 State.ExitCode、State.OOMKilled 和 State.Error。如果 OOMKilled=true,排查重点应转向内存限制与宿主内存压力;如果 State.Error 有内容,则优先处理 Docker 报告的运行时错误。

当这些字段没有直接给出答案时,docker logs 通常最关键。日志里若出现配置文件不存在、参数解析失败、连接被拒绝、权限不足等信息,就应沿着应用错误继续验证,而不是把退出码 1 当作根因。

再核对启动命令和配置

有些镜像手工运行正常,但通过 Compose、脚本或平台启动时退出 1,常见差异来自启动命令、环境变量、挂载文件和工作目录。此时要把“实际启动配置”与预期配置对照,而不是只检查镜像本身。

因此,Exited (1) 应被理解为一个定位入口:它证明主进程失败结束,但根因需要通过状态字段、日志和实际启动配置继续收敛。

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

目录与阅读设置

阅读设置

17

记录一个想法

Exited 1 到底代表什么

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

登录哪都通