如何使用Golang实现日志文件轮转_自动创建新文件并归档-Golang-PHP中文网

如何使用Golang实现日志文件轮转_自动创建新文件并归档

P粉602998670

发布： 2025-12-21 19:25:02

原创

570人浏览过

Go 标准库 log 包不支持日志轮转，需用 github.com/natefinch/lumberjack 实现按大小轮转；它轻量、API 简洁，通过 Filename、MaxSize、MaxBackups 等配置实现自动归档与压缩，且 Write 并发安全。

如何使用golang实现日志文件轮转_自动创建新文件并归档

Go 标准库的 log 包本身不支持日志轮转（如按大小或时间切分、归档旧文件），需借助第三方库或自行实现。最常用、稳定且符合生产要求的是 github.com/natefinch/lumberjack —— 它轻量、无依赖、API 简洁，专为 log.Writer 设计。

使用 lumberjack 实现按大小轮转

这是最常见场景：当日志文件达到指定大小（如 100MB），自动重命名旧文件（如 app.log.1）、创建新 app.log，并限制保留历史文件数量。

安装：go get github.com/natefinch/lumberjack
基础用法：将 lumberjack.Logger 作为 io.Writer 传给 log.SetOutput 或 log.New
关键配置项：
- Filename：日志主文件路径（如 "logs/app.log"）
- MaxSize：单个文件最大 MB 数（默认 100，单位是 MB，不是字节）
- MaxBackups：最多保留几个旧日志（如 5 表示保留 app.log.1 ~ app.log.5）
- MaxAge：旧日志最长保留天数（0 表示不限制）
- Compress：是否对归档文件启用 gzip 压缩（需 Go 1.16+）

完整可运行示例

以下代码启动一个日志器，每写入约 1MB 就触发轮转（便于测试），保留最多 3 个备份，自动压缩：

package main
<p>import (
"log"
"time"
"github.com/natefinch/lumberjack"
)</p><p>func main() {
logger := &lumberjack.Logger{
Filename:   "logs/app.log",
MaxSize:    1, // MB
MaxBackups: 3,
MaxAge:     7,
Compress:   true,
}</p><pre class="brush:php;toolbar:false;">// 将 lumberjack 作为输出目标
log.SetOutput(logger)
defer logger.Close() // 程序退出前关闭，确保缓冲写入

for i := 0; i < 100; i++ {
    log.Printf("第 %d 条日志，时间：%s", i, time.Now().Format(time.RFC3339))
    time.Sleep(100 * time.Millisecond)
}

登录后复制

}

运行后你会看到：logs/app.log（当前写入中）、logs/app.log.1.gz、logs/app.log.2.gz、logs/app.log.3.gz（若已轮转多次）。

ChatPDF

使用ChatPDF，您的文档将变得智能!跟你的PDF文件对话，就好像它是一个完全理解内容的人一样。

327

查看详情

按时间轮转？lumberjack 不直接支持，但可组合实现

lumberjack 本身不检查“是否到整点/每天零点”，但可通过外部控制实现时间维度轮转：

方案一（推荐）：用 MaxAge = 1 + 每日固定路径（如 logs/app-2024-05-20.log），由程序在每日首次写日志时切换 Filename —— 需自己维护 io.Writer 切换逻辑
方案二：配合系统 cron 或 systemd timer，每天定时执行脚本移动+压缩日志，Go 进程只负责写单一文件（简单但耦合运维）
替代库考虑：如 github.com/gogf/gf/v2/os/glog 或 github.com/rs/zerolog + 自定义 sink，但复杂度上升，非必要不建议