容器与云原生 / 系统课时
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。

用最小示例观察状态
下面创建一个明确打印错误并以 1 退出的容器。示例使用 Alpine,实际首次运行时可能先拉取镜像。
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预期输出
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) 应被理解为一个定位入口:它证明主进程失败结束,但根因需要通过状态字段、日志和实际启动配置继续收敛。