日志中间件必须返回gin.HandlerFunc类型函数,正确写法是func Logger() gin.HandlerFunc { return func(c *gin.Context) { ... c.Next() ... } };c.Next()须置于中间逻辑以获取响应状态码与耗时;全局、分组或单路由挂载影响日志范围;logrus文件日志需预初始化复用实例。

日志中间件必须返回 gin.HandlerFunc 类型
Gin 的 Use() 方法只接受 gin.HandlerFunc 类型函数,不是任意函数或闭包。如果你写了个普通函数(比如 func logReq() { ... })直接传给 r.Use(),会编译报错:cannot use logReq (type func()) as type gin.HandlerFunc。正确写法是返回一个接收 *gin.Context 参数、无返回值的函数:
func Logger() gin.HandlerFunc {
return func(c *gin.Context) {
// 前置逻辑
c.Next() // 调用后续处理(路由 handler 或下一个中间件)
// 后置逻辑(如记录状态码、耗时)
}
}
漏掉 return func(c *gin.Context) 这一层包装,就不是合法中间件。
c.Next() 的位置决定日志内容是否完整
日志里想拿到响应状态码、实际耗时、写入字节数,c.Next() 必须放在中间件函数体中间——不能在开头(此时响应还没生成),也不能在结尾之后(没机会执行后置逻辑)。常见错误是把 c.Next() 放最底下,导致 c.Writer.Status() 永远是 0,c.Writer.Size() 也是 0。
- ✅ 正确:记录耗时用
time.Since(start),状态码用c.Writer.Status(),都放在c.Next()之后 - ❌ 错误:把
log.Printf(...)写在c.Next()前面,日志里全是初始默认值 - ⚠️ 注意:
c.Writer.Status()在c.Next()前调用始终返回 0;但c.Writer.Size()和c.Writer.Written()同理
全局挂载 vs 路由组挂载影响日志覆盖范围
r.Use() 是全局挂载,所有注册在该引擎上的路由都会走这个日志中间件;而 group.Use() 只影响该分组下的路由。如果你有公开接口(如 /health)不想打日志,又或者管理后台需要更细粒度的日志字段,就不能全用全局 Use()。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 全局日志:适合统一基础字段(方法、路径、状态码、IP、耗时)
- 分组日志:比如
apiV1 := r.Group("/v1")下挂LoggerWithTraceID(),自动注入X-Request-ID - 单路由日志:极少用,但
r.GET("/debug", DebugLogger(), handler)是合法的,仅对该 endpoint 生效
用 logrus 写文件日志时,os.File 必须可复用
如果用 logrus 替代 log.Printf 并输出到每日文件,别在每次中间件调用时都 os.OpenFile() —— 文件句柄会快速耗尽,且日期切换不及时。正确做法是提前初始化好 *logrus.Logger 实例,并在 setOutputFile() 中做日期检查和文件轮转:
func setOutputFile(logDir string) (*os.File, error) {
now := time.Now()
fileName := path.Join(logDir, now.Format("2006-01-02")+".log")
if _, err := os.Stat(fileName); os.IsNotExist(err) {
os.Create(fileName) // 创建新文件
}
return os.OpenFile(fileName, os.O_APPEND|os.O_WRONLY, 0644)
}
关键点:这个函数不能在 gin.HandlerFunc 内部调用;它应该在服务启动时执行一次,然后把配置好的 logrus.Logger 传进中间件闭包里。否则每秒几百请求就会反复打开/关闭同名文件,IO 毛刺明显。
真正容易被忽略的是中间件生命周期和日志实例的绑定关系——logrus 实例本身不是 goroutine-safe 的,但 Gin 的每个请求都在独立 goroutine 中执行,所以只要确保你传进去的是同一个线程安全的 logger 实例(logrus.Logger 默认是),就没问题。别在中间件里 new 一个新的。

















