容器中途挂掉主因是内存超限被OOMKilled、健康检查失败触发重启策略、或主进程静默退出;需通过docker inspect查ExitCode和OOMKilled状态,结合docker logs分析panic/connection refused等关键词。
容器生命周期故障排查不是靠猜,而是按阶段抓关键信号。核心思路是:从容器是否“活”着开始,一层层往里挖,每层只用一两个命令快速验证,避免陷入无效操作。
看状态:先确认容器在哪个生命周期环节卡住
运行 docker ps -a,重点盯三列:
-
Status:是
Exited还是Restarting?前者说明已死,后者说明在反复拉起 -
ExitCode:137 表示被 OOM Killer 杀掉;1 表示程序崩溃;0 可能只是前台进程退出(比如没加
-d或没用tail -f类命令保活) - Created / Up 时间差:刚创建就退出,大概率是启动命令失败或依赖缺失
查日志:不只看应用日志,还要看 Docker 自身动作
分两步走:
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连(推荐)和国内镜像站加速两种模式。
- 用 docker logs --since 5m <容器名> 看最近日志,加
--tail 100避免刷屏 - 用 docker events --since 10m 查 Docker 守护进程行为,比如有没有
die、start、oom事件,能直接看到是否被内核杀掉
验配置:很多问题出在 inspect 出来的细节里
别跳过 docker inspect <容器名>,重点关注四个字段:
- .State.ExitCode 和 .State.Error:退出原因是否写明了?比如 “no such file or directory” 就是路径或二进制缺失
-
.HostConfig.RestartPolicy.Name:是不是设成了
always,掩盖了真实失败? -
.NetworkSettings.Ports:端口映射是否为空?空说明没加
-p或写错了格式 - .Mounts:挂载路径是否存在?权限是否匹配 UID?常见于宿主机目录属主是 root,但容器内进程以非 root 用户运行
进现场:该动手时就动手,但要有策略
不要一上来就 docker exec -it,先判断容器是否还在运行:
- 如果容器是
Running:用 docker exec -it <容器名> sh 进去,检查/proc/1/cmdline、环境变量、网络连通性(curl -I localhost:端口) - 如果容器是
Exited:基于原镜像启一个临时调试容器:docker run -it --rm --volumes-from <原容器名> <镜像名> sh,复用卷和配置,绕过启动逻辑直接查现场 - 必要时用 nsenter -t <PID> -n ip a 查网络命名空间,或 strace -p <PID> 看卡在哪次系统调用

















