Docker 中怎么排查容器启动失败与异常退出原因

夏辰同学_9135

夏辰同学_9135

2026-08-07

367人浏览

原创

容器exited状态说明主进程已终止,需通过退出码(如137为oom、143为sigterm)、日志和启动命令排查;cmd/entrypoint须前台长期运行;重启策略需结合内存限制与健康检查使用。

docker 中怎么排查容器启动失败与异常退出原因

容器启动失败或秒退,核心是搞清它“为什么停”——不是崩溃,而是进程结束了。Docker 容器生命周期完全由 PID 1 进程决定:它一退出,容器就终止。所以排查重点不是“它崩了”,而是“它干完啥就走了”。

看状态和退出码,先定性

别急着删重试,先确认发生了什么:

  • docker ps -a | grep 容器名 —— 查看是否在列表里、状态是不是 Exited (X) 或 Created
  • docker inspect 容器名 --format='{{.State.Status}} {{.State.ExitCode}} {{.State.OOMKilled}}' —— 一行看清状态、退出码、是否被 OOM 杀掉
  • 常见退出码含义:
    0:正常退出(比如你运行了个脚本,执行完就退出)
    1:应用内部错误(日志里找 panic、配置缺失、命令不存在)
    137:被系统 kill(大概率内存超限 OOM)
    125:Docker 命令本身出错(比如镜像名写错、参数非法)

查日志,找第一手线索

日志是关键证据,但要注意:如果入口命令瞬间失败(如文件不存在、权限拒绝),可能根本没输出日志。

OpenClaw Docker Setup
OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw,并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载
  • docker logs 容器名 —— 最基础,看 stdout/stderr
  • docker logs --tail 100 容器名 —— 日志太长时只看最后 100 行
  • docker logs -t 容器名 —— 加时间戳,方便定位发生时刻
  • docker logs --since "2h" 容器名 —— 查最近两小时日志
  • 如果日志为空,说明进程可能连标准输出都没来得及打开,问题更底层(比如 CMD 指向的文件根本不存在,或权限不对)

验配置和依赖,盯住几个关键点

很多失败不是代码问题,而是环境没搭对:

  • 端口冲突:启动时报 port is already allocated?用 sudo lsof -i :8080 或 sudo netstat -tlnp | grep :8080 查谁占着
  • 挂载权限:宿主机目录挂进容器后提示 permission denied?检查目录属主、SELinux/AppArmor 策略,或加 :z 或 :Z 标签
  • 健康检查失败:容器起来又退出,且反复重启?可能是健康检查(healthcheck)一直不通过,导致被自动 stop
  • 依赖服务未就绪:比如应用启动要连 MySQL,但 db 容器还没 ready。可在应用启动脚本里加等待逻辑,或用 depends_on + healthcheck 组合

进容器或模拟启动,做最终验证

当上面都看不出问题,就动手试:

  • 去掉后台模式,前台运行:把 docker run -d 改成 docker run(不加 -d),直接看终端输出,错误立马可见
  • 进容器手动跑命令:如果容器曾短暂运行过,用 docker start 容器名 && docker exec -it 容器名 sh,然后手动执行 CMD 中的命令,看报什么错
  • 检查镜像内容:用 docker run --rm -it 镜像名 ls -l /app 确认文件路径、权限、是否存在

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java docker

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

705

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5099

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

6057

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2313

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

239

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

451

14

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

400

26

Go Docker与容器化部署教程合集
Go Docker与容器化部署教程合集

聚焦 Go 应用的容器化部署优势与实践,讲解 Go 静态编译特性(CGO_ENABLED=0)与 scratch / distroless 极小基础镜像构建、多阶段 Dockerfile 编写规范、交叉编译生成目标平台二进制、镜像安全扫描(Trivy)与漏洞修复、Docker Compose 本地编排开发环境、Kubernetes Deployment / Service / ConfigMap 部署 Go 服务、健康检查(Livene

2026.05.15

285

24

Hyperf 项目部署运维与性能调优手册
Hyperf 项目部署运维与性能调优手册

聚焦 Hyperf 在生产环境的落地,包含 Docker 高效打包、Swoole 配置优化、常见的内存溢出(OOM)问题排查方法以及热更新方案。

2026.05.19

425

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习