Go应用只需将日志输出到os.Stdout/os.Stderr,Docker自动采集;禁用文件写入、确保换行、避免缓冲,日志配置由docker run或docker-compose.yml统一管理,Go不干预。

Go 程序本身不直接“配置 Docker 容器日志”,Docker 日志由 dockerd 和容器运行时统一管理;Go 应用只需按标准输出(stdout/stderr)写日志,Docker 才能捕获。强行在 Go 里调用 Docker API 配置日志驱动是反模式。
Go 应用该怎么做:只管输出,别碰 docker logs 配置
你的 Go 程序唯一要做的,就是把日志写到 os.Stdout 和 os.Stderr——Docker 默认日志驱动(json-file)会自动采集这些流。不要试图在 Go 里读取 /var/lib/docker/containers/xxx/xxx-json.log,也不要用 exec.Command("docker", "logs") 去拉日志。
- 使用
log.New(os.Stdout, "", log.LstdFlags)或结构化日志库(如zerolog、zap)输出到os.Stdout - 错误日志走
os.Stderr:例如log.New(os.Stderr, "ERROR: ", log.LstdFlags) - 禁用日志文件写入逻辑(比如
os.OpenFile("app.log", ...)),否则容器内会多出文件且 Docker 日志不可见 - 避免缓冲:若用
bufio.Writer包裹os.Stdout,记得每条日志后Flush(),否则日志延迟或丢失
Docker 日志配置在启动时决定,不是 Go 控制的
日志行为(保留多少、单个文件多大、用什么驱动)由 docker run 或 docker-compose.yml 指定,Go 程序无权 runtime 修改。常见配置项:
-
--log-driver=json-file(默认)、syslog、journald、fluentd等 -
--log-opt max-size=10m --log-opt max-file=3:控制日志轮转 -
--log-opt labels=environment,service:给日志加元数据(需容器启动时带--label) -
docker-compose.yml中对应字段:logging: driver: "json-file" options: max-size: "10m" max-file: "3"
为什么你看到的日志乱序或缺失?先查这三处
Go 程序日志在 docker logs 里不全、顺序错、时间戳不准,通常不是 Go 代码问题,而是环境或配置链路断了:
立即学习“go语言免费学习笔记(深入)”;
- Go 使用了
log.SetOutput(io.Discard)或重定向到文件 —— 检查main()开头有没有这类调用 - 容器以
--log-driver=none启动 ——docker inspect确认驱动非| grep LogConfig none - 日志行没换行符(
\n):Docker 按行分割日志,fmt.Print("ready")不带换行会导致后续日志粘连;务必用fmt.Println或显式fmt.Print("ready\n") - 使用了
log.Printf但没设log.Lshortfile等 flag?这不是丢失原因,但会影响可读性 —— 这类属于日志内容优化,不影响采集
想集中收集日志?Go 不用改,换 Docker 日志驱动
如果目标是把日志发到 ELK、Loki 或 Splunk,Go 应用完全不用动,只需切换 Docker 日志驱动并配好 endpoint:
- 用
fluentd驱动:docker run --log-driver=fluentd --log-opt fluentd-address=localhost:24224 my-go-app
- 用
loki(需 loki-docker-driver):docker run --log-driver=loki --log-opt loki-url=http://loki:3100/loki/api/v1/push my-go-app
- 所有驱动都要求日志必须从
stdout/stderr输出 —— 这再次印证:Go 只需保持标准输出,其余交给基础设施
最容易被忽略的是:本地开发用 docker run -d 后立刻 docker logs,却忘了 Go 程序可能有初始化延迟(比如连 DB、等 config),导致首几条日志还没打出就被你查了;用 docker logs -f 观察实时流,比一次性 docker logs 更可靠。










