Golang日志轮转：按日期或大小管理方法

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个Golang开发实战，手把手教大家学习《Golang实现日志按日期或大小轮转方法》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

Go 标准库 log 不支持日志轮转，需用第三方库：lumberjack 适合按大小轮转（如 100MB/个，保留 7 个+28 天），file-rotatelogs 适合按日期轮转（如 daily，带软链和精确时间控制）。

Go 标准库的 log 包本身不支持日志轮转（如按日期或文件大小自动切分），需借助第三方库或手动实现。最常用、稳定且轻量的方案是使用 github.com/lestrrat-go/file-rotatelogs（推荐）或 gopkg.in/natefinch/lumberjack.v2。下面分别说明两种主流方式，覆盖按时间（日期）和按大小轮转的典型场景。

使用 lumberjack 实现按大小自动轮转

适合：对日志时效性要求不高，更关注单个文件体积控制（如限制每个日志 ≤ 100MB，最多保留 7 个旧文件）

lumberjack 是一个简单可靠的日志切割器，常与标准 log 或 zap 等搭配使用：

• 安装：go get gopkg.in/natefinch/lumberjack.v2
• 基本用法示例（配合标准 log）：

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

func main() {
    logger := log.New(&lumberjack.Logger{
        Filename:   "./logs/app.log",
        MaxSize:    100, // MB
        MaxBackups: 7,   // 最多保留 7 个旧文件
        MaxAge:     28,  // 保留 28 天（即使没到 MaxBackups）
        Compress:   true, // 启用 gzip 压缩（.gz）
    }, "", log.LstdFlags)

    logger.Println("This is a log message")
}

注意：MaxAge 和 MaxBackups 是独立触发条件，任一满足即清理旧日志；Compress=true 会自动压缩归档文件（需 Go 1.16+）。

使用 file-rotatelogs 实现按日期轮转（如 daily）

适合：需要严格按日期归档（如 app-2024-05-20.log），便于按天检索、对接日志系统

file-rotatelogs 支持基于时间的精确轮转（秒/分/时/日），并可结合 logrus 或 zap 使用：

• 安装：go get github.com/lestrrat-go/file-rotatelogs
• 搭配标准 log 示例（按天切分）：

import (
    "log"
    "time"
    rotatelogs "github.com/lestrrat-go/file-rotatelogs"
    "gopkg.in/natefinch/lumberjack.v2" // 可选：仅用于压缩，rotatelogs 本身不压缩
)

func main() {
    writer, _ := rotatelogs.New(
        "./logs/app-%Y-%m-%d.log", // 模板：%Y=年，%m=月，%d=日
        rotatelogs.WithLinkName("./logs/app.log"), // 创建软链指向最新日志
        rotatelogs.WithRotationTime(24*time.Hour), // 每 24 小时轮转一次
        rotatelogs.WithMaxAge(7*24*time.Hour),     // 保留最近 7 天
        rotatelogs.WithRotationCount(7),           // 最多存 7 个文件（与 MaxAge 二者取严）
    )

    logger := log.New(writer, "", log.LstdFlags)
    logger.Println("Log written to dated file")
}

提示：WithLinkName 很实用——始终有 app.log 软链接指向当天日志，方便 tail -f；若需压缩，可额外用 lumberjack 封装 writer，或自行调用 os/exec 执行 gzip。

进阶建议：生产环境推荐组合方案

单一工具难兼顾所有需求。实际项目中建议：

• 优先用 lumberjack：简单、无依赖、稳定，适合大多数后端服务
• 如需精确日期命名 + 软链 + 高频轮转（如每小时），选 file-rotatelogs
• 避免自己实现轮转逻辑：边界情况多（并发写、rename 冲突、磁盘满处理等），易出错
• 日志路径务必使用绝对路径或确保工作目录可控，防止日志写入意外位置
• 配合 systemd 或 supervisor 时，记得关闭其自带日志重定向，避免双重日志

小技巧：快速验证轮转是否生效

启动程序后，执行以下操作观察行为：

• 手动修改系统时间（测试 date-based 轮转）或快速写满设定大小（如设 MaxSize=1，反复打印）
• 检查日志目录：是否有新文件生成、旧文件是否重命名、软链是否更新
• 用 ls -lt logs/ 看文件时间顺序，tail -f logs/app.log 确认输出流向正确文件

本篇关于《Golang日志轮转：按日期或大小管理方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！