golang如何实现日志按日期切割_golang日志按日期切割实现详解

为什么不能靠 `log.SetOutput` 手动轮换文件

很多刚入门的同学第一反应是：在每天零点调用`log.SetOutput`换一个新文件不就行了？听起来很美，但线上跑起来就是另一回事了。 - **竞态问题**：多个goroutine同时写日志时，`SetOutput`不是原子操作。你这边刚换完输出目标，那边另一个goroutine还在往旧文件里写，日志就可能被截断，或者干脆写到旧文件里。 - **句柄泄漏**：换文件时没显式关闭旧文件的句柄。在Linux环境下，fd（文件描述符）的数量是有限的，用完了程序直接就panic了，错误信息往往是“too many open files”。 - **数据丢失**：如果程序在零点前崩溃了，那么当天的日志就全丢了，而且没有任何回滚机制。 - **磁盘膨胀**：没有自动的归档和压缩逻辑，日志文件会无限制地增长，很快就能把你的磁盘空间吃光。

推荐方案：用 `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，否则它会按自己的规则删除旧文件，和你的日期逻辑就冲突了。 直接看一段核心代码，会更清楚： ```go 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`字段来赋值。 初始化代码非常简洁： ```go 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`在你部署环境（尤其是容器内时区、挂载卷权限）下的行为，这才是正道。