Golang如何实现日志文件轮转_Golang日志分文件存储实践_技术教程

日志轮转可防止文件过大、提升性能与维护性，常用lumberjack按大小轮转（如10MB切分），配合log库使用；按时间轮转则可用zap结合rotatelogs实现每日切分，推荐使用成熟库而非手动实现。

在Go项目中，日志是排查问题、监控系统运行状态的重要手段。但如果不加以管理，日志文件会不断增大，占用磁盘空间，影响系统性能。因此，实现日志文件轮转（Log Rotation）——即按大小或时间自动切分日志文件——是生产环境中的基本需求。

为什么需要日志轮转

单个日志文件持续追加会导致：

文件过大，难以查看和传输
影响程序写入性能
不便于归档和清理

通过轮转机制，可将日志按天、按小时或按大小拆分为多个文件，提升可维护性。

使用第三方库：lumberjack 实现按大小轮转

Go标准库没有内置日志轮转功能，但社区提供了成熟方案。最常用的是 lumberjack，它是一个轻量级的日志切割库，支持按大小、保留份数、压缩旧文件等特性。

安装 lumberjack：

go get gopkg.in/natefinch/lumberjack.v2

结合 Go 的标准日志库 log 使用示例：

package main

import (
  "io"
  "log"
  "os"
  "gopkg.in/natefinch/lumberjack.v2"
)

func main() {
  log.SetOutput(io.MultiWriter(os.Stdout, &lumberjack.Logger{
    Filename: "logs/app.log", // 日志输出路径
    MaxSize: 10, // 每个文件最大10MB
    MaxBackups: 5, // 最多保留5个备份文件
    MaxAge: 7, // 文件最多保存7天
    Compress: true, // 是否启用压缩（.gz）
  }))

  log.Println("这是一条测试日志")
}

当 app.log 达到 10MB 时，lumberjack 会自动将其重命名为 app.log.1，并新建 app.log 继续写入。超过 MaxBackups 或 MaxAge 的文件会被自动删除。

按时间轮转：结合 cron 和外部脚本

如果需要按天切分日志（如 app-2025-04-05.log），lumberjack 本身不直接支持时间轮转。常见做法是：

每天零点通过 cron 调用脚本重命名日志文件
发送信号通知程序 reopen 日志文件

另一种方式是使用更高级的日志库，如 uber-go/zap 配合 rotatelogs。

使用 zap + rotatelogs 示例：

go get go.uber.org/zap
go get github.com/lestrrat-go/file-rotatelogs package main

import (
  "time"
  "go.uber.org/zap"
  "github.com/lestrrat-go/file-rotatelogs"
)

func main() {
  writer, _ := rotatelogs.Ne

w(
    "logs/app-%Y%m%d.log", // 按日期命名
    rotatelogs.WithLinkName("current.log"), // 软链接指向当前日志
    rotatelogs.WithMaxAge(7*24*time.Hour), // 保留7天
    rotatelogs.WithRotationTime(24*time.Hour), // 每24小时轮转
  )

  logger := zap.New(zapcore.NewCore(
    zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()),
    zapcore.AddSync(writer),
    zap.InfoLevel,
  ))

  logger.Info("定时轮转日志测试")
  defer logger.Sync()
}