如何在 Golang 中处理日志轮转与归档_Golang 文件管理与自动化实践-Golang-PHP中文网

如何在 Golang 中处理日志轮转与归档_Golang 文件管理与自动化实践

P粉602998670

发布： 2025-12-21 20:37:02

原创

958人浏览过

使用lumberjack库可实现Go日志按大小或时间轮转，结合logrotate工具增强归档管理，避免日志无限增长。

如何在 golang 中处理日志轮转与归档_golang 文件管理与自动化实践

在 Golang 应用中，日志是排查问题、监控运行状态的重要手段。但随着系统长时间运行，日志文件会不断增长，占用磁盘空间，影响性能和维护效率。因此，实现日志轮转与归档成为生产环境中的基本需求。Golang 标准库 log 提供了基础的日志写入能力，但不支持自动轮转。我们需要借助第三方库或自行实现机制来完成这一任务。

使用第三方库实现日志轮转（如 lumberjack）

最常见且稳定的做法是结合标准库 log 与 lumberjack —— 一个专为 Go 设计的日志切割库。它可按大小、时间、备份数量等策略自动轮转日志文件。

安装方式：

go get gopkg.in/natefinch/lumberjack.v2

示例代码：

立即学习“go语言免费学习笔记（深入）”；

package main import ( "log" "os" "gopkg.in/natefinch/lumberjack.v2" ) func main() { // 配置 lumberjack 作为日志输出 logger := &lumberjack.Logger{ Filename: "/var/log/myapp/app.log", // 日志文件路径 MaxSize: 10, // 每个文件最大 10MB MaxBackups: 5, // 最多保留 5 个备份 MaxAge: 7, // 文件最多保存 7 天 Compress: true, // 启用压缩（gzip） } defer logger.Close() log.SetOutput(logger) log.SetFlags(log.LstdFlags | log.Lshortfile) // 模拟写入日志 for i := 0; i

上述配置会在日志文件达到 10MB 时自动创建新文件，并将旧文件重命名为 app.log.1、app.log.2 等，超过 5 个则删除最老的。过期超过 7 天的也会被清理，且归档文件会被压缩以节省空间。

手动实现简单轮转逻辑

若不想引入外部依赖，可以基于文件大小检测 + 重命名机制实现简易轮转。

关键步骤包括：

灵光

蚂蚁集团推出的全模态AI助手

1635

查看详情

记录当前日志文件句柄
每次写入前检查文件大小是否超过阈值
超出则关闭当前文件，将其重命名为带时间戳或序号的归档名
创建新的日志文件继续写入

示例片段：

func shouldRotate(filename string, maxSize int64) (bool, error) { fi, err := os.Stat(filename) if err != nil { return false, err } return fi.Size() > maxSize*1024*1024, nil } func rotateLog(filename string) error { if _, err := os.Stat(filename); os.IsNotExist(err) { return nil } timestamp := time.Now().Format("20060102-150405") newName := fmt.Sprintf("%s.%s", filename, timestamp) return os.Rename(filename, newName) }

这种方式灵活但需自行处理并发写入、锁机制、归档清理等问题，适合轻量级场景。