Go语言中使用Gin框架实现日志记录与归档-Golang-PHP中文网

gin 默认日志不适用于生产归档，因其仅输出到 stdout，缺乏按大小/时间切分、历史保留、权限控制和压缩能力；需替换为 lumberjack + zap 实现结构化、可归档的访问与错误日志分离方案。

go语言中使用gin框架实现日志记录与归档

为什么 Gin 默认日志不能直接用于生产归档

Gin 的 gin.Default() 自带的 gin.Logger() 只输出到 os.Stdout，不支持按大小/时间切分、不保留历史文件、无法设置权限或压缩，一跑几天日志就滚成几 GB 的单文件——线上出问题时根本没法快速定位，也违反运维对日志留存的基本要求。

真正能落地的归档，得靠替换掉默认中间件 + 接入成熟日志库。别自己写轮子，lumberjack 是最轻量且被广泛验证的选择。

用 lumberjack 配合 zap 实现带归档的结构化日志

单纯用 log.SetOutput() 接 lumberjack.Logger 会丢 Gin 的请求上下文（如 method、path、status、latency）。必须把日志逻辑从中间件重写，让 zap 承接全部输出，并用 lumberjack 管理文件写入。

lumberjack.Logger 的 MaxSize 设为 10（单位 MB），避免单文件过大影响 grep 和传输
MaxBackups 建议设为 7，配合每日归档逻辑，刚好保留一周
MaxAge 设为 7（单位天），和 MaxBackups 协同防磁盘爆满
用 zap.AddCallerSkip(1) 把日志行号定位回 Gin 中间件，而不是 zap 内部代码

示例关键片段：

lw := &lumberjack.Logger{
    Filename:   "logs/access.log",
    MaxSize:    10,
    MaxBackups: 7,
    MaxAge:     7,
    Compress:   true,
}
logger, _ := zap.NewProduction(zap.AddCallerSkip(1), zap.Output(lw))
r.Use(ginzap.Ginzap(logger, time.RFC3339, true))

如何让错误日志单独归档，避免和访问日志混在一起

访问日志（access log）和错误日志（error log）语义不同：前者高频、可丢；后者低频、需保留更久、常被监控系统采集。混在一个文件里会导致 grep "ERROR" 效率骤降，也增加日志平台解析成本。

Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载，版本号 1.9.0，适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载

做法是拆开两个 lumberjack.Logger 实例，分别绑定不同 zap.Logger：

访问日志走 lumberjack 配置如上，路径为 "logs/access.log"
错误日志另配一个 lumberjack.Logger，Filename 改为 "logs/error.log"，MaxBackups 提到 30，MaxAge 设为 30
在 Gin 中间件里，只把 status >= 400 的请求额外写进 error logger（用 logger.Error() 显式调用）

注意 Windows 下 lumberjack 的文件锁与权限问题

Windows 对文件删除更保守，lumberjack 在轮转时可能因句柄未释放干净导致 "The process cannot access the file because it is being used by another process" 错误。这不是 Gin 或 zap 的 bug，而是 OS 层限制。

缓解方式只有两个：