Docker Desktop 查看容器日志教程：定位异常容器、筛错误和 Debug 排查

本地调试容器服务时，最常见的问题不是“容器有没有启动”，而是“容器启动了，但接口还是访问不了”。这时 Docker Desktop 的图形界面很适合快速排查：先看容器列表，再进日志面板筛错误，必要时打开 Debug 终端查看进程、环境变量和健康检查结果。

本文用一个 api-web 容器做示例，演示从 Docker Desktop 界面完成一次完整排查。最终目标是确认容器是否运行、端口是否暴露、日志里是否有异常，以及服务内部健康检查是否返回 OK。

准备环境：打开 Docker Desktop 并确认引擎运行

先启动 Docker Desktop。界面左下角如果显示 Engine running，说明本机 Docker 引擎已经可用。接着确认你要排查的项目容器已经创建，比如：

• api-web：后端接口容器，对外暴露 8080 端口。
• mysql-db：MySQL 容器，对外暴露 3306 端口。
• redis-cache：Redis 容器，对外暴露 6379 端口。
• worker-job：后台任务容器，可能是停止状态。

如果左侧没有看到 Containers，先确认当前打开的是 Docker Desktop 主窗口，而不是单独的设置窗口。

步骤一：进入 Containers 视图定位容器

在左侧导航点击 Containers。中间区域会显示当前容器列表，包括名称、镜像、状态、端口、CPU、内存和操作按钮。

操作顺序如下：

1. 点击左侧 Containers。
2. 在搜索框输入容器名，例如 api-web。
3. 查看 Status 是否为 running。
4. 查看 Port(s) 是否显示 8080:8080 这类端口映射。
5. 点击容器名称或所在行，进入容器详情页。

如果容器是 exited 状态，先不要急着重启。进入详情页看日志，通常能直接看到退出原因。

步骤二：打开容器详情页查看 Logs

进入容器详情页后，默认常见入口包括 Logs、Inspect、Files、Stats、Debug、Settings。本次排查先打开 Logs。

日志面板会持续显示容器标准输出和错误输出。对于本地开发服务，建议先观察三类信息：

• 启动阶段：是否加载配置、连接数据库、连接缓存。
• 错误阶段：是否出现 ERROR、连接拒绝、端口占用、配置缺失。
• 恢复阶段：是否出现 server started、health check、connected 等稳定信号。

步骤三：搜索 ERROR 并开启时间戳

在 Logs 页面上方的搜索框输入 error，可以快速过滤异常行。再勾选 Show timestamps，把每条日志的时间显示出来。

过滤后重点看错误是否连续出现。例如：

ERROR db: connection refused
ERROR db: retry in 3s
ERROR db: retry in 5s
INFO  db: connected
INFO  http server listening on :8080

这组日志说明：容器启动初期数据库连接失败，但后续已经恢复连接，并且接口服务开始监听 8080 端口。如果页面仍然访问不了，就要继续看端口映射、内部健康检查和代理配置。

步骤四：使用 Debug 终端做健康检查

在容器详情页切到 Debug。如果你的 Docker Desktop 已启用对应能力，会打开一个容器内调试终端。这里可以检查进程、环境变量和本地健康接口。

常用检查如下：

ps
env | sort
curl -s http://localhost:8080/health

如果健康检查返回：

OK

说明容器内部服务大概率已经正常。此时如果宿主机浏览器仍访问失败，可以回到 Containers 列表检查端口映射是否正确，或者确认本机是否有其他进程占用了同一端口。

步骤五：用命令行补充过滤日志

Docker Desktop 适合图形化排查。如果需要把日志复制给同事，或持续观察最新输出，可以在终端里补充使用 docker logs。

docker logs --tail 100 api-web
docker logs --tail 100 --timestamps api-web
docker logs --since 10m api-web
docker logs --follow api-web

这些命令分别适合查看最近 100 行、显示时间戳、只看最近 10 分钟、持续跟随新日志。图形界面和命令行结合起来，排查会更快。

常见问题和处理办法

最终确认清单

• Docker Desktop 左下角显示引擎正在运行。
• Containers 视图中目标容器是 running 状态。
• 端口映射显示正确，例如 8080:8080。
• Logs 中没有连续出现新的 ERROR。
• 开启 Show timestamps 后能确认错误发生和恢复时间。
• Debug 终端里健康检查返回 OK。
• 必要时用 docker logs --tail 和 --since 补充导出日志。

排查容器问题时，建议先用 Docker Desktop 找到可见状态，再用日志和 Debug 终端确认内部状态。这样既能看到容器是否运行，也能看到服务是否真的可用。