容器启动失败应先查日志、看状态、定位原因：用docker ps -a和inspect确认状态与退出码，docker logs查stdout/stderr，再依ExitCode、端口冲突、挂载权限、配置错误等常见问题针对性解决。
容器启动失败时，别急着删镜像重来，先看日志、查状态、定位原因——大多数问题都能快速定位并解决。
一、确认容器是否真的“启动失败”
有时你以为容器没起来，其实是它启动后立刻退出了。用以下命令查看真实状态：
docker ps -a
：列出所有容器（包括已停止的），重点关注 STATUS 列，如
Exited (1) 2 seconds ago
表示启动后异常退出，括号里的数字是退出码
docker inspect <容器名或ID>
：查看详细信息，特别关注
State.Status
（running/exited）、
State.ExitCode
和
State.Error
字段
二、第一时间查看容器日志
日志是排查核心依据，尤其对前台进程崩溃、配置错误、依赖缺失等问题：
docker logs <容器名或ID>
：显示容器标准输出和标准错误（即 stdout/stderr）
加参数更高效：
•
--tail 100
：只看最后100行
•
-f
：实时跟踪（适合重启后持续观察）
•
--since "2h"
：查看2小时内日志
如果容器根本没创建成功（如
报错后无容器），日志不会存在，需看命令执行时的终端报错（比如镜像不存在、端口被占、权限拒绝等）
三、常见启动失败原因与对应解法
结合日志和状态，快速匹配典型场景：
应用启动就退出（ExitCode 非 0）
：检查应用是否以前台模式运行。Docker 容器必须有一个前台主进程维持运行，否则会立即退出。例如 Node.js 要用
而非
；Python 应用避免用
端口冲突
：宿主机端口已被占用，启动时提示
。用
（macOS/Linux）或
（Windows）查进程并释放
挂载路径权限/不存在
：如
中宿主机路径不存在，或容器内程序无权读写该目录（尤其 Alpine 镜像默认以非 root 用户运行）。可加
临时测试，但生产环境建议修复目录权限或用
指定用户
配置文件或环境变量错误
：日志中常出现
、
等。用
进入镜像，手动检查配置路径、语法、变量值
四、进阶调试技巧
当常规日志不够用时：
以交互方式运行容器
：用
或
，手动执行启动命令，观察实时报错
检查镜像入口点和命令
：运行
，确认实际执行逻辑是否符合预期
启用 Docker 的 debug 日志
（较少需要）：修改
加入
，重启 docker daemon，再查
docker runnode server.jsnpm start &python app.py &Bind for 0.0.0.0:8080 failedlsof -i :8080netstat -ano | findstr :8080-v /host/path:/container/path--privilegeduser:failed to load configinvalid value for ENV_VARdocker run -it --rm <镜像名> shdocker run -it --rm <镜像名> shbashdocker inspect <镜像名> | grep -A 5 'Entrypoint\|Cmd'/etc/docker/daemon.json"debug": truejournalctl -u docker.service -n 100