lumberjack 不能直接按天切日志,因其不识别时间,仅依据文件大小或数量轮转;需手动拼接带日期的 filename 并在每次写入前比对日期,动态关闭旧文件、打开新文件,同时设置 localtime: true 避免 maxage 时区偏差。

lumberjack 为什么不能直接按天切日志
因为 lumberjack.Logger 本身不识别时间,它只看文件大小或数量。所谓“按天轮转”,得靠你主动控制 Filename 每天变一次,再配合 lumberjack 的基础轮转逻辑——否则哪怕设置了 MaxSize,旧日志也可能跨天堆积,或者同一天生成多个文件。
常见错误现象:log-2024-05-20.log 写到一半,凌晨没切,第二天还在往这个文件里写;或者每写满 100MB 就切一个新文件,但文件名全是 app.log.1、app.log.2,根本看不出日期。
- 必须自己拼接带日期的
Filename,比如"logs/app-" + time.Now().Format("2006-01-02") + ".log" -
lumberjack的MaxAge是清理用的(删掉多少天前的旧文件),不是触发切割的条件 - 如果程序长期运行不重启,每天零点不会自动重开文件——得你自己在日志写入前判断日期是否变更
如何安全地实现每日新建日志文件
核心是:每次写日志前检查当前文件名是否还匹配今天日期,不匹配就关闭旧 Writer、打开新文件。不能依赖定时器或 goroutine 轮询,容易漏写或并发冲突。
使用场景:后台服务持续运行,要求日志文件名含日期、单个文件不跨天、旧文件自动归档清理。
- 把
lumberjack.Logger封装进一个结构体,保存当前Filename和time.Time记录最后写入日期 - 每次调用
Write前,用time.Now().Format("2006-01-02")对比缓存的日期,不一致就调用Rotate()(需先Close()再重建) - 注意
lumberjack.Rotate()不是公开方法,得手动Close()后重新赋值Output字段 - 避免在
Write中做 I/O 操作(如打开文件),应提前准备好io.Writer实例并加锁保护
简短示意:
初始化并管理阿里云SDK Go 客户端,涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
type DailyLogger struct {
mu sync.Mutex
writer io.Writer
today string
}
func (l *DailyLogger) Write(p []byte) (n int, err error) {
now := time.Now().Format("2006-01-02")
l.mu.Lock()
defer l.mu.Unlock()
if now != l.today {
if l.writer != nil {
l.writer.(*lumberjack.Logger).Close()
}
filename := fmt.Sprintf("logs/app-%s.log", now)
l.writer = &lumberjack.Logger{
Filename: filename,
MaxSize: 100, // MB
MaxAge: 7, // days
}
l.today = now
}
return l.writer.Write(p)
}
MaxAge 和 LocalTime 的坑必须避开
lumberjack 默认用 UTC 时间判断 MaxAge,如果你服务器时区是 CST(东八区),那它删文件的时间会比本地时间晚 8 小时——可能你以为昨天的日志已被清理,其实还躺在磁盘上。
另一个典型问题:MaxAge 只在每次写入时检查,如果某天完全没日志,那天的文件永远不会被删。
- 务必设置
LocalTime: true,否则MaxAge、MaxBackups的行为和你预期不符 -
MaxAge不是“保留最近 N 天”,而是“删除早于 N 天前最后修改时间的文件”,所以静默期会导致残留 - 如果对清理强依赖,建议额外加个简单 cron 或启动时扫描清理,别只信
lumberjack
为什么不用 logrus + lumberjack 组合直接搞
很多人一上来就套 logrus.SetOutput,结果发现日志还是不按天分——因为 logrus 只管写,不参与文件名决策。它把字节丢给 io.Writer 就完事,而 lumberjack.Logger 又不解析时间,两者叠加也不等于自动日期切分。
性能影响很小,但封装层级多了容易误判责任归属:比如看到日志没按天切,第一反应是 “logrus 配错了”,其实问题出在 Filename 没动态更新。
- 不要把
lumberjack.Logger当成黑盒塞给logrus就完事 - 如果坚持用
logrus,必须自定义io.Writer实现每日切换逻辑,而不是直接传&lumberjack.Logger{...} - 更轻量的做法:跳过
logrus,直接用log.SetOutput+ 自定义io.Writer,减少一层抽象干扰
time.Now().Format 里。golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










