Lumberjack 是 Go 日志轮转最常用选择，因其轻量无依赖、稳定且被 zap/logrus 等默认集成，作为 io.WriteCloser 无缝适配任意日志后端，解决标准库不支持按大小/时间轮转的问题。
为什么 Lumberjack 是 Go 日志轮转最常用的选择
因为标准库 log 和 io.Writer 本身不支持按大小或时间切分文件，而 Lumberjack 是社区事实标准——它轻量、无依赖、稳定，且被 zap、logrus 等主流日志库默认集成。它不是“日志框架”，只是一个带轮转能力的 io.WriteCloser，所以能无缝替换任何接受 io.Writer 的日志后端。
常见错误现象：直接用 os.OpenFile 配合 log.SetOutput，结果日志文件越写越大，磁盘爆满；或者自己手写定时器+重开文件，却在并发写入时触发 write on closed file panic。
-
Lumberjack.Logger必须在每次写入前检查是否需要轮转，这个逻辑已封装好，无需手动干预 - 它只处理“写入时轮转”，不提供日志级别过滤、格式化、异步刷盘等功能——这些得靠上层日志库完成
- 注意：它默认不压缩旧日志（
Compress: false），如果需要 gzip，必须显式开启并确保系统有gzip可执行文件（仅当LocalTime: true且压缩启用时才调用外部命令）
怎么配置 Lumberjack.Logger 避免丢日志或卡死
核心是理解三个关键字段：Filename、MaxSize、MaxBackups。它们共同决定“什么时候切”和“切多少个”。配置不当会导致日志静默丢失，或轮转时阻塞主线程。
-
Filename必须是绝对路径（如/var/log/myapp/app.log），相对路径在 daemon 化后容易指向意外位置 -
MaxSize单位是 MB，但实际触发轮转的阈值是「当前文件大小 ≥ MaxSize × 1024 × 1024」，不是“超过就立刻切”——它只在每次写入前检查，所以可能略超（通常 -
MaxBackups控制保留几个旧文件，设为0表示不限制数量（危险！），生产环境建议 ≤ 7 - 务必设置
LocalTime: true，否则轮转文件名里的时间戳是 UTC，排查时容易看错 - 如果程序高频写日志（如每毫秒一条），建议把
MaxAge设为 0（禁用按天轮转），避免每天零点大量 rename 操作引发 I/O 尖峰
示例配置：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
lumberjackLogger := &lumberjack.Logger{
Filename: "/var/log/myapp/app.log",
MaxSize: 100, // MB
MaxBackups: 7,
MaxAge: 0,
LocalTime: true,
Compress: true,
}
Lumberjack 和 zap / logrus 结合时的坑
很多人以为传个 lumberjack.Logger 进去就万事大吉，结果发现日志没进文件，或轮转后新日志仍写到旧文件里。问题几乎都出在「Writer 生命周期管理」上。
- 用
zap时，必须通过zapcore.AddSync包裹lumberjack.Logger，不能直接传指针——否则 zap 可能提前 close 它 - 用
logrus时，别用logrus.SetOutput(lumberjackLogger)，而要用logrus.SetOutput(&writerWrapper{lw: lumberjackLogger})自定义 wrapper（因为 logrus 在某些版本会反复 close writer） - 所有日志库都要求：你的
lumberjack.Logger实例必须全局复用，不能每次打日志都 new 一个——否则每个实例独立计数，轮转完全失效 - 如果程序要优雅退出（如收到
SIGTERM），记得调用lumberjackLogger.Close()，否则最后一批缓冲日志可能丢失
轮转失败时怎么快速定位是权限、磁盘还是代码问题
最常见的表现是日志停写、文件大小停滞、或报错 rename /var/log/.../app.log /var/log/.../app.log.2024-05-01: invalid cross-device link。这不是 Lumberjack 的 bug，而是底层 syscall 限制。
- 先看错误日志里有没有
failed to rotate log file—— 有则说明轮转阶段出错，重点查磁盘空间和权限 - 用
df -h /var/log确认磁盘剩余空间 ≥MaxSize × (MaxBackups + 1)，否则轮转会静默失败（它不会主动删旧文件腾空间） - 检查
Filename所在目录的写权限：运行用户能否touch新文件？能否rename？尤其注意挂载点跨设备（如/var/log是单独挂载的 tmpfs 或 NFS）时，rename必然失败，必须改用Copy + Remove模式（Lumberjack不支持，得换库或自己 patch） - 临时加一行
fmt.Printf("rotate: %v\n", lumberjackLogger.Rotate())到日志写入前，可验证轮转逻辑是否被触发
真正麻烦的从来不是“怎么配”，而是轮转发生在高负载、多进程、跨文件系统、权限收紧的生产环境里——这时候连 open 系统调用都可能被 SELinux 拦住，得去查 audit.log。
