容器启动后立即退出的根本原因是主进程（PID 1）失败或终止，需通过docker logs和docker inspect获取退出码及日志，结合常见退出码（如1、127、137等）定位配置错误、命令缺失、内存不足等问题。
容器启动后立即退出（Exited）是 Docker 最常见的问题之一，根本原因在于容器内主进程（PID 1）启动失败或迅速终止。Docker 容器的生命周期完全依赖于这个主进程：进程退出，容器就停止，状态变为 Exited (X)，其中 X 是该进程的退出状态码（exit code）。定位问题的关键就是查清这个数字，并结合镜像行为和运行命令来判断根源。
查看退出状态码与日志是第一步
不要只看 docker ps -a 中的 Exited (X)，必须立刻获取日志和详细退出信息：
-
执行
docker logs <container_id>—— 大部分错误（如配置错误、连接失败、脚本报错）都会输出到 stdout/stderr，这是最直接线索； -
执行
docker inspect <container_id> | grep -A 5 "State"—— 查看ExitCode和FinishedAt，确认是否真为非零退出，排除因docker stop导致的正常 0 退出； - 若容器秒退且无日志，可能是主进程根本没来得及输出（例如二进制缺失、权限拒绝），此时需结合
docker run -it交互式运行复现。
常见退出码含义与典型场景
以下是最常遇到的非零退出码及其对应原因：
-
Exit Code 1：通用错误。常见于 Shell 脚本语法错误、命令未找到（
/bin/sh: xxx: not found）、Python/Node.js 程序抛出未捕获异常； -
Exit Code 2：误用内置 Shell 命令（如
grep找不到匹配项会返回 1，但某些封装脚本可能映射为 2）；更常见的是容器启动命令写错，比如docker run nginx echo hello—— 启动后立刻执行echo并退出，Nginx 根本没运行； -
Exit Code 126：权限问题。目标命令不可执行（
Permission denied），例如脚本缺少+x权限，或使用了不兼容架构的二进制（如在 ARM 容器里运行 x86 程序）； -
Exit Code 127：命令未找到（
command not found）。典型如ENTRYPOINT ["/app/start.sh"]，但镜像里根本没有该路径，或路径写错； -
Exit Code 137：被系统 OOM Killer 终止（Out of Memory）。容器内存超限，Linux 强制 kill PID 1。检查
docker stats或dmesg | grep -i "killed process"； - Exit Code 139：段错误（Segmentation fault）。程序尝试访问非法内存地址，常见于 C/C++ 程序 bug、动态库版本冲突、或使用了不兼容的 CPU 指令集（如 AVX）；
-
Exit Code 143：收到 SIGTERM 后正常退出（如
docker stop）。这不是故障，而是优雅终止；若不该停却停了，需检查是否有外部调用 stop、健康检查失败触发重启策略、或进程自己监听并响应了信号。
快速排查与修复流程
按顺序执行以下操作，90% 的 Exited 问题可定位：
-
用
docker run -it --rm <image> <command>代替docker run -d—— 让容器前台运行，实时看到错误输出； - 确认
Dockerfile中的CMD或ENTRYPOINT是否正确指向长期运行的进程（如nginx -g "daemon off;"、python app.py），而非一次性命令（如ls、echo）； - 检查挂载卷（-v）路径是否存在、权限是否允许容器用户读写（尤其注意 SELinux/AppArmor 限制）；
- 验证环境变量是否传入正确（
-e KEY=VAL），缺失必要变量常导致程序初始化失败； - 对于多阶段构建镜像，确认最终 stage 是否完整复制了运行时依赖（如 Python 包、so 库、配置文件）；
- 使用
docker run --entrypoint /bin/sh <image>进入容器，手动执行 CMD 命令，观察报错细节。
预防性建议
减少 Exited 类问题发生，关键在构建和运行阶段养成习惯：
- 在
Dockerfile中明确指定非 root 用户（USER 1001），并确保该用户对所需目录有权限； - 所有 Shell 启动脚本开头加
set -e，让任意命令失败立即中断，避免静默错误； - 用
HEALTHCHECK主动探测服务是否真正就绪（不只是端口通），配合--restart=on-failure时更可靠； - 上线前用
docker run --memory=512m --memory-swap=512m限制资源，提前暴露内存/OOM 问题； - 记录标准启动命令模板，避免每次手动敲错（例如漏掉
-g "daemon off;"导致 Nginx 后台化后容器退出）。
