应改用中间件方式注入request ID：在request ID中间件之后注册自定义日志中间件，通过c.Get("X-Request-ID")安全获取并格式化输出，避免误用LoggerWithConfig或修改DefaultWriter导致的上下文丢失、竞态等问题。
gin.LoggerWithConfig 里怎么加 request ID
原生 gin.LoggerWithConfig 不自动注入 request ID，必须手动在 Formatter 函数中从上下文提取。Gin 本身不生成 request ID，得先确保它已存在于 c.Request.Context() 或 c.Keys 中（比如由前置中间件如 request_id 注入）。
常见错误是直接访问 c.Request.Header.Get("X-Request-ID") —— 这只读原始 Header，而多数 request ID 中间件（如 gin-contrib/requestid）会写进 c.Keys 或 context.Value。
- 确认 request ID 已注入：检查是否调用了类似
r.Use(requestid.New())的中间件 - 在
Formatter中安全取值：reqID, ok := c.Get("X-Request-ID")，避免 panic - 如果用
context.WithValue注入，需通过c.Request.Context().Value(key)获取，但 Gin 官方推荐用c.Get()
自定义 Formatter 里如何安全拼接 request ID 字段
Formatter 是个纯函数，接收 gin.LogFormatterParams，但它**不包含 *gin.Context**，所以不能直接调用 c.Get()。必须改用 gin.LoggerWithWriter + 自定义 writer，或改用中间件方式——这是最容易踩坑的地方。
正确做法是放弃 LoggerWithConfig，改写一个轻量中间件：
func RequestIDLogger() gin.HandlerFunc {
return func(c *gin.Context) {
start := time.Now()
c.Next()
reqID, _ := c.Get("X-Request-ID")
statusCode := c.Writer.Status()
latency := time.Since(start)
logStr := fmt.Sprintf("[%s] | %d | %v | %s | %s | %s | %s\n",
time.Now().Format(time.RFC3339),
statusCode,
latency,
c.ClientIP(),
c.Request.Method,
c.Request.URL.Path,
reqID,
)
fmt.Print(logStr) // 或写入 io.Writer
}
}
然后注册：r.Use(RequestIDLogger())，顺序要放在 request ID 中间件之后。
为什么不能直接修改 DefaultWriter 来加 request ID
gin.DefaultWriter 是全局变量，所有请求共用同一个 io.Writer 实例，它没有上下文感知能力。你没法在写日志时动态拿到当前请求的 reqID —— 因为 DefaultWriter 的 Write([]byte) 方法根本不接收 *gin.Context。
试图用闭包捕获 c 会失败，因为 DefaultWriter 在日志输出时早已脱离请求生命周期。
- 修改
DefaultWriter只适合静态重定向（如全量写入文件），不适合带上下文字段的日志 - 哪怕配合
gin.DisableConsoleColor()，也无法解决 request ID 动态注入问题 - 强行 hack（比如用 goroutine-local map 存 reqID）会导致竞态和内存泄漏，不推荐
使用第三方日志库（如 zap）时 request ID 怎么透传
如果项目已用 zap，request ID 通常通过 zap.AddCallerSkip(1) 和 zap.String("req_id", reqID) 注入。关键点在于：必须在每个 handler 或中间件里显式把 reqID 塞进 logger 实例，而不是依赖全局 logger。
更稳妥的做法是封装一个带 context 的 logger：
func (l *Logger) WithReqID(c *gin.Context) *zap.Logger {
reqID, _ := c.Get("X-Request-ID")
return l.zap.With(zap.String("req_id", fmt.Sprintf("%v", reqID)))
}
然后在 handler 里：l.WithReqID(c).Info("user fetched", zap.String("user_id", "123"))。
注意：不要在中间件里一次性把 reqID 写进全局 zap.Logger，否则并发请求会互相覆盖字段。
