Gin框架日志重复记录排查指南
在使用Gin框架开发Web应用时，高效可靠的日志记录至关重要。然而，有时会遇到同一请求日志重复记录的问题，例如，一次请求却在日志文件中出现了多次相同的记录。本文将分析Gin中间件中可能导致日志重复记录的原因，并提供排查方法。
以下代码片段展示了一个自定义的Gin中间件logerMiddleware，用于将日志写入文件：
// 日志记录到文件
func LogerMiddleware() gin.HandlerFunc {
// ... (日志文件路径和名称设置，与原文相同) ...
// 写入文件
src, err := os.OpenFile(fileName, os.O_RDWR|os.O_CREATE|os.O_APPEND, 0777)
if err != nil {
fmt.Println("err", err) // 错误处理，建议使用更完善的错误处理机制
}
// ... (logrus配置，与原文相同) ...
return func(c *gin.Context) {
startTime := time.Now()
c.Next()
endTime := time.Now()
logger.Infof("%3d | %8v | %13s | %s | %s | %s | %s | %s |",
c.Writer.Status(),
endTime.Sub(startTime),
c.ClientIP(),
c.Request.Method,
c.Request.RequestURI,
c.Request.Proto,
c.Request.UserAgent(),
c.Request.Referer(),
)
}
}
该中间件使用logrus和rotatelogs库进行日志记录和文件轮转。如果观察到日志中同一请求出现多次记录，且时间戳不同，则问题可能并非代码逻辑错误，而是由实际请求导致的。
排查步骤：
-
确认请求次数： 使用网络抓包工具（如Wireshark、Charles）或服务器端访问日志，仔细检查是否存在实际的重复请求。前端代码、负载均衡器或其他中间件都可能导致重复请求。
-
检查中间件逻辑： 虽然提供的代码片段看起来没有明显的重复写入逻辑，但为了谨慎起见，可以检查
logerMiddleware中是否存在潜在的并发问题或其他可能导致意外多次调用的情况。例如，确保logger.Infof调用只在c.Next()之后执行一次。 -
排查logrus和rotatelogs配置： 确保
logrus和rotatelogs的配置正确，不会导致日志写入异常。 检查rotatelogs的轮转策略是否正确，避免因文件轮转导致日志重复。 -
完善错误处理： 在
os.OpenFile处添加更完善的错误处理，避免因文件打开失败而导致日志丢失或写入异常。 -
简化测试： 创建一个简单的测试用例，模拟请求，并观察日志输出。这有助于隔离问题，并快速定位错误。
总结：
日志重复记录问题通常并非由Gin中间件本身的bug引起，而是由重复请求或其他系统问题导致。 通过以上步骤，系统地排查请求来源和中间件逻辑，可以有效解决Gin框架日志重复记录的问题。 记住，完善的错误处理和清晰的日志记录本身也是排查问题的关键。
