Docker 容器运行正常,日志却查不到?日志驱动、输出位置与保留策略排查

容器状态正常但 docker logs 没有内容,通常与应用输出位置、日志驱动、Compose 重建和日志轮转有关。本文按应用 stdout/stderr、容器实际驱动、日志查看入口、文件安全、保留策略和验收顺序逐层排查,覆盖 json-file、local、远程驱动与 Compose 配置。
Docker 容器运行正常,日志却查不到?日志驱动、输出位置与保留策略排查

容器状态是 Up,服务也能访问,执行 docker logs 却没有内容,或者只能看到很早以前的几行。这类问题通常与日志输出路径不一致有关:应用写进了容器内文件,容器使用了 none 或远程日志驱动,Compose 重建后换了容器,或者日志已经按策略轮转。

排查时先确认应用输出位置,再确认容器实际使用的日志驱动,最后检查保留策略和宿主机磁盘。Docker 默认使用 json-file,但日志驱动可以在 daemon、单个容器或 Compose 服务层级覆盖;改完 daemon 配置后,已有容器不会自动采用新设置。

先看容器是否真的在写标准输出

docker logs 读取的是容器主进程的标准输出和标准错误。很多 Web 服务器、PHP-FPM、Java 应用和数据库默认把日志写到容器内文件,进程运行正常并不代表这些日志会出现在 Docker 日志流中。

先找进程和启动参数:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

再分别检查 stdout、stderr 和容器内日志目录:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

精简镜像可能没有 sh、find 或 ls,这时应通过应用自身的健康检查、诊断容器或镜像文档确认输出位置。不要为了看日志直接修改生产容器里的配置;容器重建后,手工改动可能消失。

应用使用文件日志时,要确认文件是否有持久化挂载。容器被删除后,未挂载到卷或宿主机目录的文件通常也会随容器消失。日志文件写进容器层还会增加 Docker 数据目录的占用。

查看容器实际使用的日志驱动

不要只看 docker info。它显示的是 Docker daemon 的默认值,单个容器可能在创建时指定了不同驱动。直接检查目标容器:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

如果返回 none,该容器没有可供 docker logs 读取的日志。使用 syslog、journald、fluentd、awslogs 等远程或系统日志驱动时,日志应到对应后端查看。某些外部日志驱动在未启用兼容读取时,docker logs 可能没有有用输出。

Compose 服务可以单独指定日志配置:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

修改文件后,确认实际执行了重建:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

只改 compose.yaml 而不重建,旧容器仍可能保留旧驱动。

找到日志文件时不要直接编辑

对 json-file,Docker 会把每个容器的日志保存为 JSON 格式,并记录输出来源和时间戳。这些文件由 Docker daemon 专用,使用外部工具直接读取、截断或删除,可能干扰日志系统。

定位 Docker 数据目录和容器 ID:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

确认数量和时间范围:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

怀疑日志量导致磁盘紧张时,再检查 Docker 数据目录所在分区:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

具体路径可能因 data-root、Docker Desktop 或发行版配置而不同。Windows/WSL2 的 Docker Desktop 有独立的 daemon 日志位置,不能按 Linux 路径猜测。

配置轮转,避免日志把磁盘写满

默认 json-file 没有自动轮转时,输出量大的容器可能持续占用宿主机磁盘。Docker 官方建议使用带默认轮转的 local 驱动,或给 json-file 配置 max-size 和 max-file。

Linux Docker Engine 可以在 daemon.json 中设置默认策略:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

log-opts 的值需要写成字符串,包括看起来像数字的 max-file。改完后按当前环境重启 Docker Engine,并重新创建容器。不要直接重启生产 Docker 服务,先确认维护窗口和业务影响。

也可以让新容器使用 local:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

local 使用 Docker 管理的格式,并默认进行轮转,适合不需要直接读取 JSON 文件的场景。如果业务必须集中检索,应选择明确的远程日志后端,并设置失败处理、凭据保护和保留周期。切到远端不会自动迁移旧容器的历史日志。

用一套验收判断故障是否解决

修改后不要只看容器状态。用一条不含敏感信息的测试日志验证完整链路:

对应命令可按本节说明在目标容器、Docker 主机或日志平台执行。

如果容器没有 sh,使用应用支持的测试输出方式。对于远程驱动,到对应日志平台按容器名、时间范围和唯一标记搜索;对于文件日志,确认挂载目录、权限、轮转和备份策略。

验收至少覆盖:新容器采用预期驱动,docker logs 或目标后端能看到新日志,轮转后仍保留约定范围,磁盘增长不会失去控制。还要验证容器重建、节点重启和日志后端短暂不可用时的行为。

排查顺序固定为应用输出位置、容器驱动、Compose 是否重建、查看入口、轮转和磁盘,能避免在宿主机上反复搜索文件,也能避免为了让 docker logs 有内容而破坏原本的集中日志设计。

官方参考资料

资料核验日期:2026 年 11 月 17 日。

  1. Docker Docs:Configure logging drivers
  2. Docker Docs:JSON File logging driver
  3. Docker Docs:Compose services – logging
  4. Docker Docs:Read the daemon logs
Docker与容器

Docker 构建磁盘越用越满?build cache、dangling images 与 prune 排查

2026-11-12 10:36:49

知识库

全量、增量、差异备份:三种策略怎么选?

2026-7-6 14:59:10