Logrus 输出日志到 stdout 但容器里看不到？检查 os.Stdout 是否被缓冲
Go 默认的 log 包和 logrus 都会写入 os.Stdout，但在容器中常出现“日志写了却查不到”的情况——根本原因是 Go 运行时对 os.Stdout 的行缓冲行为：当输出不带换行符、或未显式刷新时，内容可能卡在缓冲区里，容器日志采集器（如 Docker、K8s）收不到。
解决方法不是改日志库配置，而是确保标准输出是无缓冲或行缓冲的：
- 启动程序前加
stdbuf -oL -eL ./your-app（仅调试用，非生产） - 更可靠的做法：在
main()开头强制设置os.Stdout为行缓冲：import "os" import "bufio" func main() { os.Stdout = bufio.NewWriter(os.Stdout) defer os.Stdout.(*bufio.Writer).Flush() // 后续所有 println / fmt.Println / logrus.Info 都能及时刷出 } - Logrus 用户可直接调用
logrus.SetOutput(os.Stdout)，但注意这不会改变缓冲策略，仍需上面的bufio处理
Zap 日志格式必须匹配容器日志系统解析规则
Kubernetes、Docker daemon、Loki 等默认按 JSON 行解析日志。如果用 zap.NewDevelopmentConfig()，它输出的是带颜色、带空格的可读格式，容器日志采集器会把整行当一条日志，但字段无法提取（比如 level、ts 变成纯文本）。
必须用生产级配置，并确保时间戳、级别、消息字段名与常见采集器约定一致：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
zap.NewProductionConfig()，它默认启用JSONEncoder，字段名为"level"、"ts"、"msg"、"caller" - 避免自定义
EncodeLevel或EncodeTime改变字段语义，比如把"level"改成"severity"，会让 Stackdriver 或 Loki 的 level 过滤失效 - 若需添加 trace_id 等字段，用
logger.With(zap.String("trace_id", tid))，别硬塞进 encoder —— 动态字段应走With，静态结构由 encoder 控制
Logrus Hook 在容器中失效？别用 file 或 syslog Hook
容器内路径不可靠、/dev/log 不一定存在、挂载卷权限受限——这些都会让 logrus.FileHook、logrus.SyslogHook 静默失败或 panic。
容器场景下唯一安全的输出方式就是直接写 os.Stdout，其他通道都该禁用：
- 删掉所有
logrus.AddHook(...)，只保留logrus.SetOutput(os.Stdout) - 不要用
logrus.SetFormatter(&logrus.JSONFormatter{})+FileHook组合，那是给 VM 用的 - 如果真需要转发到远端（如 Kafka、HTTP endpoint），必须用异步、带重试、有背压控制的专用 Hook（如
lestrrat-go/file-rotatelogs不适用，它还是落盘） - 常见错误现象：
logrus不报错但日志消失 → 检查hook.Fire()是否 panic 被吞了，加defer func(){ if r := recover(); r != nil { fmt.Fprintln(os.Stderr, "hook panic:", r) } }()
多 goroutine 写日志导致容器日志乱序？Zap 是线程安全的，Logrus 不是
Logrus 默认的 Entry 和 Logger 实例不是并发安全的——多个 goroutine 直接调用 logrus.Info() 可能导致字段覆盖、panic 或日志内容错乱（比如 A 的 user_id 和 B 的 req_id 拼在同一行）。
Zap 的 *zap.Logger 是完全并发安全的，但 Logrus 必须显式处理：
- Logrus 方案：全局只用一个
*logrus.Logger，且所有日志必须通过WithFields()构造新Entry，再调用Info()——Entry是一次性的，不复用 - 错误写法：
var entry = logrus.WithFields(logrus.Fields{"user_id": "123"}) go func() { entry.Info("start") }() go func() { entry.Info("done") }() // 危险：两个 goroutine 共享同一 entry - Zap 更推荐：直接用全局
*zap.Logger，它内部已做 sync.Pool 优化，logger.Info("msg", zap.String("key", "val"))可放心并发调用
最易被忽略的一点：无论用 Logrus 还是 Zap，都别在日志里打敏感信息（token、password、完整 request body），容器日志默认是明文落盘+可被任意 pod 读取的。字段过滤必须在写入前做，而不是依赖日志采集器的脱敏规则。
