首页/云/Docker 容器速查/容器起不来的通用排查路径
容器排障52 条

容器起不来的通用排查路径

五步法:看状态与退出码 → 看日志尾部 → 看 inspect 的 Error 字段 → 用同镜像交互复现 → 再回到 Dockerfile/参数层面修正。

Docker 容器速查云更新于 2026-10-12
第一步docker ps -a 看状态与退出码
第二步docker logs --tail 200
第三步inspect 看 State.Error / Health 字段

示例

示例
docker ps -a --filter name=web
docker logs --tail 200 web
docker inspect -f 'status={{.State.Status}} exit={{.State.ExitCode}} err={{.State.Error}}' web
docker run --rm -it --entrypoint sh web:1.0
交互复现时用 --entrypoint 覆盖原入口,手动执行启动命令观察真实报错。

易错点

  • 日志为空不等于没问题:进程可能没到打印日志就退出,先看退出码与 Error
  • 改动参数后忘记重建容器,仍在用旧配置复现问题,是常见自坑

数据来源与参考

  • Docker 官方文档:Debugging containers(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌