lumberjack.Logger 是最省心的日志切割方案,但仅支持按大小和按天轮转,不支持按小时、按分钟或自定义时间点切割;需显式设置 Mode: 0644 保证可读性,并注意父目录存在、Windows 文件占用、并发写入优化等问题。

用 lumberjack.Logger 是最省心的方案,但必须注意它不支持按小时切割
绝大多数 Golang 服务用 lumberjack 做日志切割就够了——它开箱即用、线程安全、自动压缩归档。但它的核心限制是:只支持按大小(MaxSize)和按天(MaxAge)触发轮转,**不支持按小时、按分钟或自定义时间点切割**。如果你需要“每小时一个文件”或者“凌晨 2 点强制切”,lumberjack 直接不满足。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
-
MaxSize单位是字节,不是 MB —— 写100 * 1024 * 1024,别写100或"100MB" -
Filename路径需确保父目录存在,否则首次写入会静默失败(无 panic,但日志消失) - Windows 下若日志文件被编辑器打开,
os.Rename会失败且无错误提示,旧文件卡住不滚动 - 多 goroutine 高频打点时,避免在循环里密集调用
logrus.Info;建议加缓冲或合并日志条目,减少Write()调用频次
lumberjack.Logger.Mode 必须显式设为 0644,否则运维查不到日志
默认新日志文件权限是 0600(仅属主可读写),这意味着即使你把日志放在 /var/log/myapp/,非 root 用户(比如运维、监控脚本)也打不开。更糟的是:旧文件重命名后保留原权限,新文件却永远是 0600,导致权限不一致。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 必须显式设置
Mode: 0644,例如:<pre class="brush:php;toolbar:false;">log.SetOutput(&lumberjack.Logger{ Filename: "./app.log", MaxSize: 100 * 1024 * 1024, Mode: 0644, }) - 该字段只影响新创建的文件,已存在的旧日志权限不会自动修正,上线前可用
find ./logs -name "*.log*" -exec chmod 0644 {} \; 批量修复 - Linux 下还要确认进程 umask 是否覆盖了权限位(如 umask 0027 会让
0644实际变成0640)
自己实现轮转?关键在锁、原子性和异步压缩
当你要支持“每小时切一次”“保留最近 7 天 + 最近 50 个文件”“切割后立即 gzip”等需求时,lumberjack 就不够用了。自己写不难,但容易在并发和边界上翻车。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 所有文件操作(
os.Stat、os.Rename、os.OpenFile)必须包裹在同一个sync.Mutex里,不能只锁判断逻辑而漏掉Rename - 不要用
time.Now().Hour()判断是否跨小时——要用time.Ticker定时触发,否则跨小时瞬间可能漏切 - 压缩必须异步:切割完成后起 goroutine 调用
exec.Command("gzip", ...),千万别阻塞Write()主流程 - 避免在
Write()中做耗时操作(如检查磁盘空间、远程校验),否则日志写入会卡顿甚至超时
别忽略 logrotate 这个系统级备选方案
很多团队过早陷入“一定要代码里切”的思维,其实 Linux 上的 logrotate 更稳定、更可控,尤其适合长期运行的后台服务。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 配置里务必加
copytruncate(如果程序不支持SIGHUP重载句柄),否则切完日志后 Go 进程还在往旧 inode 写,磁盘空间不释放 - 测试用
sudo logrotate -f /etc/logrotate.d/myapp,别只靠 cron 自动跑才发现配置错 - Go 程序只需用标准
os.OpenFile(..., os.O_APPEND)打开日志,完全不用管轮转逻辑 - 注意:
logrotate不处理压缩中的并发读写冲突,如果同时有脚本在zcat正在压缩的日志,可能报gzip: stdin: not in gzip format
真正麻烦的不是选哪个方案,而是混合使用时没对齐行为——比如代码里用 lumberjack 切割,又配了 logrotate 每天再切一次,结果文件名冲突、权限错乱、压缩嵌套。定方案前先问清楚:谁负责清理?谁负责压缩?谁负责查看?三者权限和节奏得咬合上。

















