Golang日志按日期切割实现方法

Go标准库的log包不支持按日期自动切割日志，手动通过SetOutput轮换文件极易引发竞态、日志丢失、文件句柄泄漏甚至进程崩溃等严重问题；本文深入剖析了这些陷阱，并给出了两种生产级可靠方案：一是基于lumberjack封装支持日期感知的轮转写入器（需谨慎处理锁、关闭与时间判断），二是推荐更省心的zerolog配合rotatelogs——原生支持定时切割、软链接指向最新日志、时区适配和自动清理，真正解决“切不断、丢不了、删得净、扛得住”的线上日志运维痛点。

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学习网公众号！