log.printf在容器中不可见是因为日志未输出到stdout/stderr;应确保log.setoutput(os.stdout)或使用logrus/zap等支持json的库并配置为输出到stdout,避免文件写入、手动缓冲复用及日志爆炸。

为什么 log.Printf 在容器里看不到日志?
容器运行时(如 Docker)默认只捕获进程的标准输出(stdout)和标准错误(stderr)。Go 程序若用 log.SetOutput 指向文件、内存缓冲或自定义 writer,日志就“消失”了——根本没进 stdout,自然无法被 docker logs 或日志采集器(如 Fluent Bit、Loki)捕获。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 删掉所有
log.SetOutput(os.File)或log.SetOutput(bytes.Buffer)类调用 - 确保所有日志最终流向
os.Stdout(默认行为)或显式设为log.SetOutput(os.Stdout) - 避免在初始化阶段静默重定向日志——哪怕只是临时调试,也容易漏掉上线前检查
如何让 Go 日志适配 JSON 格式供 Loki / Elasticsearch 解析?
纯文本日志对结构化查询极不友好。Loki、Elasticsearch 等工具依赖字段(如 level、service、trace_id)做过滤与聚合。Go 原生 log 包不支持 JSON,必须换库或封装。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 轻量场景:用
github.com/sirupsen/logrus+logrus.JSONFormatter,注意设置logrus.SetOutput(os.Stdout) - 高性能/云原生场景:改用
go.uber.org/zap,搭配zapcore.NewJSONEncoder,它比 logrus 更快且内存更可控 - 务必禁用
logrus.SetReportCaller(true)或zap.AddCaller()(除非真需要),否则会拖慢吞吐、增加日志体积 - 示例关键行:
log := logrus.WithField("service", "api").WithField("env", os.Getenv("ENV"))—— 静态字段应提前注入,而非每条日志重复加
多 goroutine 写日志导致乱序或 panic 怎么办?
Go 的 log、logrus、zap 默认都是并发安全的,但常见误操作会破坏这一点:
- 手动复用未同步的
bytes.Buffer或自定义 writer - 在日志 handler 中修改全局变量(如动态切换输出文件)
- 用
log.SetFlags(0)后又在多个 goroutine 里调log.Panicf—— Panic 会终止程序,不是并发问题而是逻辑错误
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 坚持使用库的默认 logger 实例(如
logrus.StandardLogger()),不要自己 new 多个并混用 - 若需不同行为(如 debug 日志写文件、error 写 stdout),用
logrus.AddHook而非多个 logger - 在容器中,**永远不要尝试轮转日志文件**——交给宿主机日志驱动(如
docker run --log-driver=json-file --log-opt max-size=10m)
如何避免日志爆炸压垮容器内存或磁盘?
高频打点(如 HTTP 请求日志每毫秒一条)、未控制采样率的 trace 日志、循环内无条件 log.Info,都会快速耗尽容器的 stdout 缓冲区或被日志驱动堆积到磁盘满。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- HTTP 访问日志这类高密度日志,用中间件控制频率:
if r.URL.Path != "/healthz" && logLevel == logrus.InfoLevel { log.WithFields(...).Info("req") } - 对调试级日志(
Debugf)加环境开关:if os.Getenv("DEBUG") == "1" { log.Debug(...) },上线时彻底关闭 - 用
logrus.LevelHooks或 zap 的LevelEnablerFunc实现动态降级,比如错误突增时自动把 Info 降为 Warn - 注意:Docker 默认
json-file驱动不自动清理,必须配--log-opt max-size=10m --log-opt max-file=3,否则容器根目录会被/var/lib/docker/containers/**/json.log塞爆
真正棘手的是日志内容本身不可控——比如把整个 HTTP body 当字符串打出来,或序列化失败的 struct 打印成千行 panic 堆栈。这类问题不会报错,但会在凌晨三点让你收到磁盘告警。










