Gin框架Logrus日志回滚配置-Golang-PHP中文网

logrus + rotatelogs 是 gin 集成 logrus 时最稳妥的按时间轮转方案，支持多实例并发写入，需在 init 或 main 开头配置 setoutput，避免与 gin.logger() 冲突，并正确设置 withrotationtime、withlinkname 和 withmaxage 等参数。

gin框架logrus日志回滚配置

logrus + rotatelogs 实现按时间轮转

直接用 rotatelogs 替换默认输出，是 Gin 集成 Logrus 时最稳妥的日志回滚方案。它不依赖文件锁或进程信号，靠时间戳生成新文件，天然支持多实例并发写入（比如部署多个 pod）。

常见错误是把 WithRotationTime 设得太小（如 1 * time.Minute），导致每分钟新建一个文件，但没配 WithMaxAge 或 WithRotationCount，磁盘很快被撑爆。

WithRotationTime(24 * time.Hour) 表示每天切一次，文件名带 %Y%m%d；设成 1 * time.Hour 就是每小时切
WithLinkName("logs/latest.log") 会创建软链接指向最新日志，方便运维脚本读取，但注意路径必须可写且父目录已存在
WithMaxAge(7 * 24 * time.Hour) 和 WithRotationCount(7) 二选一：前者按保留天数清理，后者按文件个数清理；混用会导致行为不可预期

logrus.SetOutput() 必须在初始化阶段调用

如果在中间件里、或者 c.Next() 之后才调用 logrus.SetOutput()，日志会漏写——因为 Logrus 全局 logger 在首次调用 Info() 等方法时就已绑定默认输出（os.Stderr），后续再改 SetOutput 不影响已缓存的 handler。

正确做法是在 main() 开头或 init() 函数里完成全部配置：

func init() {
    writer, _ := rotatelogs.New(
        "logs/app-%Y%m%d.log",
        rotatelogs.WithLinkName("logs/latest.log"),
        rotatelogs.WithRotationTime(24*time.Hour),
        rotatelogs.WithMaxAge(7*24*time.Hour),
    )
    logrus.SetOutput(writer)
    logrus.SetFormatter(&logrus.TextFormatter{FullTimestamp: true})
    logrus.SetLevel(logrus.InfoLevel)
}

别在中间件里 new 一个 logrus.Logger 再 set output——那只是局部实例，Gin 默认 logger 和你自定义的中间件 logger 不是一回事。

gin.Logger() 中间件和 logrus 冲突怎么办

如果你用了 router.Use(gin.Logger())，它会用自己的 io.Writer 输出到控制台，和你配置的 logrus.SetOutput() 完全无关。两者并存会导致日志重复、格式错乱、甚至 panic（比如 gin.Logger() 往已关闭的文件句柄写）。

Gin框架 1.9.0

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

下载

解决方式只有两个：

彻底弃用 gin.Logger()，自己写中间件，用 logrus.WithFields() 记录请求信息
保留 gin.Logger() 仅用于开发调试（输出到 os.Stdout），生产环境用 logrus 单独接管，且确保 router.Use() 里不同时挂两个日志中间件

典型错误是既调 gin.Default()（自带 Logger()），又在 main() 里配 logrus.SetOutput()，结果线上日志一半进文件、一半刷屏，还互相干扰。