能,但只适合开发或低流量场景;它输出固定格式文本日志到os.Stdout,不支持结构化、不可分级、无法注入trace ID,也不记录请求体和响应体。

gin.Logger() 能不能直接用?
能,但只适合开发或低流量场景。它输出固定格式的文本日志到 os.Stdout,不支持结构化、不可分级、无法注入 trace ID,也不记录请求体和响应体。gin.Logger() 本质是包装了 log.Printf 的简单中间件,调用 r.Use(gin.Logger()) 后就能看到类似 2024/05/12 14:22:33 | 200 | 1.245µs | 127.0.0.1 | GET "/api/users" 的输出。
常见误用:
- 把它和自定义日志混着写,结果日志时间戳错乱、顺序交错
- 以为它能捕获 status code 就不再包装 ResponseWriter,结果 handler panic 时 status 始终为 0
- 在生产环境开着它打 info 级日志,磁盘 IO 成瓶颈
为什么自己写日志中间件容易丢 body?
因为 http.Request.Body 是单次读取的 io.ReadCloser。中间件里调用 io.ReadAll(r.Body) 一次后,后续 handler 再读就得到空字节或 EOF,导致 json.Unmarshal 失败、参数解析为空。
安全做法必须复制流:
- 用
bytes.Buffer缓存原始 body 数据 - 用
io.NopCloser(bytes.NewReader(buf.Bytes()))构造新Body - 注意:要手动确保新
ReadCloser的Close()被调用,否则可能泄漏 - 仅在调试或审计等明确需要 body 的场景开启,线上默认关闭
示例关键行:buf, _ := io.ReadAll(r.Body)r.Body = io.NopCloser(bytes.NewReader(buf))
立即学习“go语言免费学习笔记(深入)”;
如何正确包装 ResponseWriter 获取 status 和 size?
标准 http.ResponseWriter 不暴露已写状态码和字节数,必须实现 wrapper 类型来拦截 WriteHeader 和 Write 调用。
核心逻辑:
- 定义结构体字段:
wrapped http.ResponseWriter、status int(初始 0)、size int、wroteHeader bool -
WriteHeader(code int)中设status = code并标记wroteHeader = true -
Write(p []byte)中若未调过WriteHeader,先隐式调用wrapped.WriteHeader(http.StatusOK),再更新status和size - 所有写入通过
io.MultiWriter(wrapped, &sizeCounter)分发,避免漏统计
漏掉隐式 200 的情况很常见——handler 直接 Write 而没调 WriteHeader,wrapper 必须兜底。
zap + 自定义中间件上线前必须检查什么?
用 uber-go/zap 替代 gin.Logger() 是生产首选,但几个点不检查清楚,日志就等于没写:
-
zap.NewProduction()默认禁用 console 输出,日志全进文件或网络,得确认zapcore.AddSync配置的 writer 是否可写 - trace ID 必须从
c.Request.Context()提取,不是从c.Keys或全局变量;若追溯中间件没在最外层注册,这里就是空 - 不要在日志里直接拼
c.Request.Header或c.Request.Form,它们含未导出字段,fmt.Sprintf("%+v")会 panic - 避免在中间件里调
c.Abort()后还继续写日志——此时c.Writer.Status()可能仍是 0,得用c.IsAborted()判断是否提前终止
最易被忽略的是 context 传递时机:trace 中间件必须在熔断、日志之前注册,否则日志字段里 trace_id 永远为空。


















