更新于

Docker 退出码是什么意思?容器秒退、立即退出时看 0、1、125、137、139、143、255

简短回答:Docker 退出码是容器主进程结束时返回的状态。0 表示正常结束;1 和 2 是应用自己的错误;125 表示 Docker 没能把容器跑起来;126 和 127 表示命令执行不了或找不到;137 和 139 表示进程被信号终止。139 是 11 号信号 SIGSEGV(段错误):128 + 11 = 139。先看 docker inspect 里的 State.ExitCode。

CI 显示部署成功,可没过几秒,docker ps -a 里就是 Exited (1) 或 Exited (127),用户那边已经打不开了。本文写给刚把应用部署到 VPS 的开发者和创始人:先确认容器状态和退出码,再对照下面的说明看这个退出码通常意味着什么、不能说明什么,最后读已退出容器的日志,找出第一条异常。如果容器一直在 Restarting 和退出之间来回切换,那是重启循环:先在这里拿到退出码,再接着看 Docker 容器一直重启怎么排查。

下面的命令都是只读的。只在你有权限的服务器上执行,把 YOUR_CONTAINER 换成实际的容器名或 ID。

1. 先读出 docker exit code(退出码)

docker ps -a --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'
docker inspect --format '{{.State.ExitCode}} {{.State.OOMKilled}} {{.State.Error}}' YOUR_CONTAINER

用 Compose 部署的话,docker compose ps -a 会列出这个项目的所有容器(包括已停止的),容器名一般是 <项目名>-<服务名>-1。

想知道进程实际跑了多久、有没有重启策略在起作用:

docker inspect --format 'started={{.State.StartedAt}} finished={{.State.FinishedAt}} restarts={{.RestartCount}} policy={{.HostConfig.RestartPolicy.Name}}' YOUR_CONTAINER

started 和 finished 只差几秒,就是典型的“秒退”。这两个时间是 UTC(结尾带 Z),和部署时间、按本地时间记录的宿主机日志对比时,先换算成同一个时区(北京时间 = UTC + 8 小时)。

这一步不能说明:进程为什么退出。它也不能保证你看的是对的容器,顺手核对一下容器名和镜像 tag 是不是你刚部署的那一个。

2. docker exit code 对照

退出码通常含义先跑哪条命令下一步去哪
0主进程正常结束docker inspect --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' YOUR_CONTAINER退出码 0
1应用自己报错(通用错误码)docker logs --since 30m --timestamps YOUR_CONTAINER 2>&1 | head -n 80退出码 1,再看第 4 步
2shell 语法错误、命令行参数用错,或应用自定义的错误docker logs --timestamps YOUR_CONTAINER 2>&1 | head -n 30退出码 2
125Docker 自己没能运行这个容器CI / 部署日志里 docker run 的报错,以及 docker inspect --format '{{.State.Error}}' YOUR_CONTAINER退出码 125
126找到了命令,但执行不了docker inspect --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' YOUR_CONTAINER;再对比 docker image inspect --format '{{.Os}}/{{.Architecture}}' YOUR_IMAGE 和 uname -m退出码 126
127找不到命令docker inspect --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' YOUR_CONTAINER退出码 127
132非法指令,SIGILL(128 + 4)sudo dmesg -T | grep -i 'invalid opcode' | tail -n 10退出码 132
137被 SIGKILL 杀掉(128 + 9)docker inspect --format '{{.State.OOMKilled}}' YOUR_CONTAINERDocker 退出码 137 与 OOMKilled
139段错误,SIGSEGV(128 + 11)sudo dmesg -T | grep -i segfault | tail -n 20退出码 139
143收到 SIGTERM 后退出(128 + 15)docker events --since 1h --until "$(date +%s)" --filter container=YOUR_CONTAINER退出码 143
255程序返回了 −1、ssh 失败,或 Docker 重启后找不到原进程docker logs --timestamps YOUR_CONTAINER 2>&1 | tail -n 30,再看 uptime -s退出码 255

「先跑哪条命令」一列假设你已经跑过第 1 步的 docker ps -a 和 docker inspect。状态如果是 Restarting (N),先在这里查 N;重启循环本身看 Docker 容器一直重启怎么排查。

大于 128 的退出码一般表示“被信号(退出码 − 128)终止”。在 bash 里执行 kill -l 137 会输出 KILL,遇到不认识的退出码可以这样换算。其他数字是应用自己定义的返回值,含义以它的日志或文档为准。

3. 每个退出码是什么意思、下一步查什么

退出码 0:主进程正常结束

容器按启动命令把事做完了,没有报错就结束了。如果是迁移、备份这类一次性任务,0 就是预期结果。Web 服务以 0 退出,多半是进程把自己放到了后台(开了守护进程模式,或者启动脚本用 & 拉起服务后自己就返回了),或者启动命令本来就是一次性任务。看看容器到底被配置成运行什么:

docker inspect --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' YOUR_CONTAINER

它不能说明:代码有问题,或者服务一切正常。它只说明主进程没有报错就结束了。

退出码 1:应用自己报错

很多语言和框架遇到任何未捕获的异常或启动检查失败,都是退出 1。看日志(第 4 步),找第一条异常,再对照这次部署改了什么:镜像 tag、环境变量、配置、数据库迁移。

它不能说明:具体是哪个错误。缺配置、数据库连不上、语法错误,退出码都一样。

退出码 2:shell 语法错误、用法不对,或应用自定义的错误

退出码 2 在 Docker 里没有专门的含义,就是主进程自己返回的值。容器里常见的来源有下面几种,看日志开头几行就能分清:

怎么确认:

docker inspect --format '{{.State.ExitCode}}' YOUR_CONTAINER
docker inspect --format 'entrypoint={{json .Config.Entrypoint}} cmd={{json .Config.Cmd}}' YOUR_CONTAINER
docker logs --timestamps YOUR_CONTAINER 2>&1 | head -n 30

如果入口是 shell 脚本,在构建镜像的机器上检查它,不用真的运行:

bash -n entrypoint.sh
grep -c $'\r' entrypoint.sh

bash -n 只解析脚本、报告语法错误(纯 #!/bin/sh 脚本用 sh -n)。grep -c 输出带回车符的行数,0 表示换行符没问题。

常见的修法(都是变更,由你决定):把脚本转成 LF 换行(sed -i 's/\r$//' entrypoint.sh,并在 .gitattributes 里加 *.sh text eol=lf 防止再变回去),然后重新构建;改正 command: 里的参数;修正文件路径;Go 程序 panic 的话,看调用栈里最先出现的、属于你自己代码的那几帧。

它不能说明:具体是哪一种原因。同样是 2,不同程序的意思不一样,以日志为准。

退出码 125:Docker 没能运行这个容器

docker run 命令或 daemon 拒绝了这次请求,你的进程通常根本没启动。看 CI / 部署日志里 docker run 或 docker compose up 打印的报错,以及第 1 步的 State.Error。常见的有参数写错、镜像拉取被拒、端口已被占用(这时用 sudo ss -ltnp 看是谁占着端口)。

125、126、127 可能来自两个地方。如果是 Docker 没能把进程启动起来,它们是 docker run 命令本身的退出码:你会在 CI 或部署日志里看到,容器通常停在 Created,报错信息在 State.Error 里(如果 docker run 返回的是 125,docker inspect 里容器自己的 ExitCode 可能是别的值,比如 128)。如果是容器已经跑起来、里面的 shell 或入口脚本遇到同样的问题,容器本身就会以 126 或 127 退出,报错在 docker logs 里。

它不能说明:应用有 bug。

退出码 126:找到了命令,但执行不了

检查配置的启动命令(用 退出码 0 里那条 docker inspect),以及镜像里这个文件的权限和格式。bind mount 挂进来的脚本沿用宿主机上的文件权限,宿主机上没有执行权限,这里就会报 126。再对比一下镜像平台和宿主机架构:

docker image inspect --format '{{.Os}}/{{.Architecture}}' YOUR_IMAGE
uname -m

架构不匹配(比如镜像是 linux/arm64,宿主机是 x86_64)时,日志里通常会出现 exec format error。

它不能说明:文件不存在。126 是“执行不了”,127 才是“找不到”。

退出码 127:找不到命令

你想运行的程序根本没跑起来。先检查启动命令,再确认这个程序在这个镜像里存在,并且在 PATH 上。换了更精简的基础镜像、Compose 的 command: 写错,都很常见。容器里的 shell 脚本调用了不存在的命令,也会以 127 退出。

它不能说明:程序启动后崩溃了。

退出码 132:非法指令(SIGILL)

132 = 128 + 4:进程被 4 号信号 SIGILL 终止(kill -l 132 输出 ILL),也就是 CPU 遇到了一条它执行不了的指令。真实的原因有这几类:

怎么确认:

docker inspect --format '{{.State.ExitCode}} {{.State.OOMKilled}} {{.State.FinishedAt}}' YOUR_CONTAINER
docker logs --timestamps YOUR_CONTAINER 2>&1 | tail -n 20
sudo dmesg -T | grep -i 'invalid opcode' | tail -n 10

再对比 CPU 支持什么、镜像需要什么:

grep -m1 '^flags' /proc/cpuinfo | grep -o -w -E 'avx|avx2|avx512f' | sort -u
/lib64/ld-linux-x86-64.so.2 --help | grep -E 'x86-64-v[234]'
docker image inspect --format '{{.Os}}/{{.Architecture}}' YOUR_IMAGE
uname -m

第一条列出这台机器的 CPU 暴露了哪些 AVX 指令集(在虚拟机里就是客户机看到的),没有输出表示都不支持。第二条(x86_64、glibc 2.33 及以上,即 Ubuntu 22.04 及更新版本)列出标为 supported 的 x86-64 级别。再拿它们去对照镜像里那个具体版本的官方 CPU 要求。

常见的修法(都是变更,由你决定):换一个官方 CPU 要求这台机器能满足的版本;把虚拟机的 CPU 类型改成透传宿主机 CPU 特性(或者找云厂商处理);换到 CPU 更新的主机;跨架构的情况,换成为宿主机架构构建的镜像。改重启策略没用,同一条指令每次都会失败。

它不能说明:CPU 一定太旧。先排除“程序故意触发陷阱”的情况,再考虑换服务器。

退出码 137:被 SIGKILL 杀掉

137 = 128 + 9:有东西发了 SIGKILL。看第 1 步里的 OOMKilled:是 true,内存是首要怀疑方向;是 false,更可能是 docker kill、docker stop 等满了宽限期,或者宿主机上的其他进程。光有 137 不能证明是内存不足。 完整的排查(内核日志、内存上限、docker events)见 Docker 退出码 137 与 OOMKilled。

退出码 139:段错误(SIGSEGV)

退出码 139 表示容器主进程被 11 号信号 SIGSEGV 终止。进程因信号结束时,Docker 记在 State.ExitCode 里的值是 128 加信号编号:128 + 11 = 139。SIGSEGV 是段错误:内核发现进程访问了它不能用的内存地址,于是停掉这个进程。

常见来源是原生代码里的缺陷:应用自己的二进制、它加载的原生库,或基础镜像和这个库不匹配。退出码本身不指出是哪个函数或哪个库。非法指令是退出码 132(SIGILL),不是 139。

怎么核对(只读):

docker inspect --format '{{.State.ExitCode}} {{.State.FinishedAt}}' YOUR_CONTAINER
sudo dmesg -T | grep -i segfault | tail -n 20
docker logs --timestamps YOUR_CONTAINER 2>&1 | tail -n 40

State.ExitCode 应为 139。内核日志里带 segfault 和程序名的那一行,时间要和 FinishedAt(UTC)对得上,才算同一次退出的证据。dmesg -T 显示宿主机本地时间;机器挂起过的话,换算可能有偏差。内核会限制这类消息的频率,没有这一行不能反过来证明没发生段错误。进程死在原生代码里时,docker logs 可能在崩溃处直接停住,没有应用自己的报错。

它不能说明:是哪个文件、哪个库或哪一行引起的。

退出码 143:收到 SIGTERM 后退出

143 是正常的停止请求。查是谁让它停的:重新部署、docker stop、docker compose down / up 重建容器、宿主机关机,或者编排工具。docker events 加上你的部署时间线,一般就能回答。Docker 只保留最近的事件(最后 256 条),所以出事后尽早查:

docker events --since 1h --until "$(date +%s)" --filter container=YOUR_CONTAINER

它不能说明:程序崩溃了。真正要问的是谁发的,以及替换它的新容器有没有起来。

退出码 255:程序返回了 −1、ssh 失败,或者 Docker 找不到原进程

255 是进程能报告的最大退出码,具体含义由程序自己决定。实际中常见的来源:

怎么确认:

docker inspect --format 'exit={{.State.ExitCode}} started={{.State.StartedAt}} finished={{.State.FinishedAt}} policy={{.HostConfig.RestartPolicy.Name}}' YOUR_CONTAINER
docker logs --timestamps YOUR_CONTAINER 2>&1 | tail -n 30
uptime -s
sudo journalctl -u docker.service --since "24 hours ago" --no-pager | grep -i -E 'starting up|completed initialization'

它不能说明:你的代码崩溃了。也可能是远端主机拒绝了 ssh,或者应用好好的、Docker 在它底下重启了。

这里没列出的退出码

大于 128 的退出码,减去 128 就是信号编号,也可以让 bash 直接告诉你名字:kill -l 134 输出 ABRT。小于 128、上面又没讲到的退出码,是应用自己定义的返回值,含义以它的日志或文档为准。不管哪种,下一步都是读日志里的第一条异常(第 4 步)。

4. 读已退出容器的日志,找第一条异常

docker logs --since 30m --timestamps YOUR_CONTAINER 2>&1 | head -n 80
docker logs --since 30m --timestamps YOUR_CONTAINER 2>&1 | grep -n -i -E 'error|fatal|panic|exception|denied|not found|refused' | head -n 20

常见的第一条异常(在核实之前都只是假设):

把日志贴到群里、工单或 AI 之前,先遮掉密码、令牌、连接串、客户邮箱和内部地址。

在 OpsMate 里怎么做

OpsMate(itops.sh)把 SSH 终端和 AI 放在同一个服务器页面。上面的 docker ps、docker inspect、docker logs 你都可以直接手敲,查退出码这种事通常手敲最快。也可以用一句话把问题告诉 AI,比如“查一下 YOUR_CONTAINER 为什么部署后就退出,总结日志里最早出现的几条错误”。AI 会提出排查命令,除了看日志,也可以用 docker、journalctl、ps、df、ss 这类命令做检查;命令跑完后,点击「需要分析」,AI 会给出结论。命令和输出都留在终端里,你可以拿原始日志核对 AI 的结论。每次让 AI 帮忙看,终端里最近的输出都会一起发到云端 AI,敏感信息请先去掉。桌面端默认保证的只是 SSH 凭证留在本机。日志里有客户数据或密钥时,建议自己手敲命令,只把脱敏后的片段交给 AI。

边界

说明性示例

说明性示例(不是真实客户案例):把镜像换成更精简的基础镜像后,docker ps -a 显示 Restarting (127) 4 seconds ago。docker inspect 输出 127 false,报错信息为空,说明 Docker 已经把进程启动起来了,也不是内存被杀。started 和 finished 只差一秒左右。docker logs --since 15m --timestamps 的第一行是 /app/start.sh: 5: exec: gunicorn: not found:入口脚本跑起来了,但新的基础镜像里没有应用服务器。这时改重启策略、加内存都没用。下一步由人来决定:回滚到上一个镜像 tag,或者重新构建时把依赖装上,然后观察容器能不能稳定运行。

AI 排查提示词

这台服务器上有个容器部署后几秒就退出。请先只做检查、不做任何改动,看看:它的 State.ExitCode、OOMKilled、Error、StartedAt、FinishedAt 和重启次数,汇总部署之后日志里最早出现的错误(带时间戳),并说明这个退出码通常意味着什么、不能说明什么。请区分已证实的事实和推测,列出还缺少的信息。不要重启或删除容器,不要修改重启策略、Compose 文件或内存上限。如果需要变更,先给出最小步骤、风险、验证方法和回退方案,等我确认。

根据证据选择下一步

试用

每月免费 500 次 AI 调用,服务器数量不限。桌面端默认把 SSH 凭证保留在本机。

常见问题

Docker 容器为什么一启动就秒退、立即退出?

容器秒退,是因为它的主进程结束了。先用 docker ps -a 看退出码,再用 docker logs YOUR_CONTAINER 找部署之后的第一条报错,而不只看最后一行。docker inspect 里 StartedAt 和 FinishedAt 只差几秒,就是典型的秒退。如果是 Web 服务以 0 退出,多半是进程把自己放到了后台,或者启动命令本来就是一次性任务。

Docker 退出码 1、125、126、127 分别是什么意思?

1 是应用自己报错的通用错误码,缺配置、数据库连不上、语法错误都是它,要看日志里的第一条异常。125 是 Docker 自己没能运行这个容器,比如参数写错、镜像拉取被拒、端口已被占用。126 是找到了命令但执行不了,常见是没有执行权限或 CPU 架构不匹配。127 是找不到命令,常见于换了更精简的基础镜像,或 Compose 的 command: 写错。

退出码 139、143 或其他大于 128 的数字是什么意思?

大于 128 的退出码一般表示被信号终止,减去 128 就是信号编号;在 bash 里执行 kill -l 139 可以直接看到信号名。139 是段错误(SIGSEGV),进程访问了非法内存,可以用 sudo dmesg -T | grep -i segfault 查内核记录。143 是收到 SIGTERM 后退出,属于正常的停止请求,要查是重新部署、docker stop 还是宿主机关机让它停的。

Docker 退出码 137 是内存不足吗?

不一定。137 = 128 + 9,表示主进程被 SIGKILL 杀掉。先看 docker inspect 里的 OOMKilled:是 true,内存是首要怀疑方向;是 false,更可能是 docker kill、docker stop 等满了宽限期,或者宿主机上的其他进程。完整排查见「Docker 退出码 137 与 OOMKilled」。

需要帮助理解排查结果?

OpsMate(itops.sh)帮助开发者和运维人员用 AI 辅助排查,由你核对证据。每次让 AI 帮忙看,终端里最近的输出都会一起发到云端 AI,敏感信息请先去掉。

免费开始 本地凭证桌面端

排障指南