go标准库log不支持按日期切割,需用lumberjack封装或rotatelogs等成熟方案;手动setoutput轮换易致竞态、日志丢失、句柄泄漏。

Go 标准库的 log 不支持按日期切割,必须借助第三方库或手动封装 —— 直接用 os.OpenFile + 定时检查会踩到竞态、丢失日志、文件句柄泄漏等坑。
为什么不能靠 log.SetOutput 手动轮换文件
很多人尝试在每天 0 点调用 log.SetOutput 换新文件,但实际运行中会出问题:
- 多个 goroutine 同时写日志时,
SetOutput是非原子操作,可能某条日志被截断或写入旧文件 - 没显式关闭旧文件句柄,Linux 下 fd 耗尽后程序 panic(错误信息类似
too many open files) - 如果程序在 0 点前崩溃,当天日志全丢,且无回滚机制
- 没有归档压缩逻辑,日志目录迅速膨胀
推荐方案:用 lumberjack.Logger 配合时间判断
lumberjack 本身只按大小切割,但可以包装一层,用 time.Now().Format("2006-01-02") 控制文件名,并在每次写入前检查日期是否变更。关键点:
- 把
lumberjack.Logger的Filename设为带日期的模板,例如"logs/app-%s.log",每次写前拼上当前日期 - 用
sync.Once或简单 flag 避免高频检查,比如每 10 秒查一次日期是否变化 - 切换时先
Rotate()(触发lumberjack关闭旧文件),再更新Filename和内部io.Writer - 务必设置
lumberjack.MaxAge = 0,否则它会按自己的规则删旧文件,和你的日期逻辑冲突
示例核心逻辑:
type DateRotatingWriter struct {
mu sync.RWMutex
writer *lumberjack.Logger
filename string
today string
}
func (w *DateRotatingWriter) Write(p []byte) (n int, err error) {
today := time.Now().Format("2006-01-02")
w.mu.RLock()
needRotate := today != w.today
w.mu.RUnlock()
if needRotate {
w.mu.Lock()
if today != w.today {
w.writer.Close() // 必须显式 close,否则文件不 flush
w.writer.Filename = fmt.Sprintf(w.filename, today)
w.today = today
}
w.mu.Unlock()
}
return w.writer.Write(p)
}
更省心的选择:zerolog + rotator 组合
如果你已在用 zerolog,直接集成 github.com/lestrrat-go/file-rotatelogs 更稳妥:
- 它原生支持
WithLinkName创建软链指向最新日志,方便脚本读取 - 切割时机由
WithRotationTime控制,底层用time.Ticker,无竞态 - 自动处理时区(传
time.Local即可)、秒级精度、保留策略(WithMaxAge) - 注意:它的
Write方法不是 goroutine-safe,需包一层io.MultiWriter或用zerolog.ConsoleWriter的Out字段赋值
简短初始化示例:
rl, _ := rotatelogs.New(
"logs/app-%Y%m%d.log",
rotatelogs.WithLinkName("logs/latest.log"),
rotatelogs.WithRotationTime(24*time.Hour),
rotatelogs.WithMaxAge(7*24*time.Hour),
)
logger := zerolog.New(rl).With().Timestamp().Logger()
真正麻烦的不是“怎么切”,而是“切的时候有没有丢日志、有没有卡住主线程、旧文件删没删干净”。日期切割看似简单,但线上服务扛不住哪怕一次 write: broken pipe 或 permission denied —— 所以别自己造轮子,优先验证 lumberjack 封装或 rotatelogs 在你部署环境(尤其是容器内时区、挂载卷权限)下的行为。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











