必须包装 http.ResponseWriter 才能捕获真实状态码和响应体大小,因原生接口不暴露状态码,WriteHeader 后仍返回 0,导致日志误记大量 200;需自定义结构体重写 WriteHeader 和 Write 方法,并将包装后实例传给 next.ServeHTTP。

http.Handler 包装必须能捕获真实状态码和响应体大小,否则日志里的 404、500 或 200 都可能是错的——这是最常被忽略的一点。
为什么默认的 http.ResponseWriter 无法记录状态码
Go 标准库的 http.ResponseWriter 接口不暴露状态码,WriteHeader 调用后也不会返回当前值。直接在中间件里读 w 得到的永远是 0(未写入状态),导致日志全显示 200,哪怕实际返回了 401 或 502。
解决办法是用一个包装器实现 WriteHeader 和 Write 方法,把状态码和字节数存下来:
type loggingResponseWriter struct {
http.ResponseWriter
statusCode int
size int
}
func (lrw *loggingResponseWriter) WriteHeader(code int) {
lrw.statusCode = code
lrw.ResponseWriter.WriteHeader(code)
}
func (lrw *loggingResponseWriter) Write(b []byte) (int, error) {
if lrw.statusCode == 0 {
lrw.statusCode = http.StatusOK
}
n, err := lrw.ResponseWriter.Write(b)
lrw.size += n
return n, err
}
如何在中间件中正确调用 next.ServeHTTP
必须把包装后的 loggingResponseWriter 传给 next.ServeHTTP,而不是原始 w;否则所有拦截逻辑都失效。
- 错误写法:
next.ServeHTTP(w, r)—— 状态码和大小仍不可见 - 正确写法:
next.ServeHTTP(lrw, r)—— 所有写操作经过包装器 - 注意:要确保
lrw.statusCode在Write之前被设为200,否则没显式调用WriteHeader时会记录为0
日志格式里该包含哪些关键字段
生产环境真正有用的字段不是“谁访问了”,而是“能不能快速定位问题”。建议至少包括:
立即学习“go语言免费学习笔记(深入)”;
-
r.Method和r.URL.Path—— 请求动作与资源路径 -
lrw.statusCode—— 实际返回码,不是猜测值 -
time.Since(start)—— 耗时,单位用time.Millisecond更直观 -
r.RemoteAddr(可选)—— 用于排查异常来源,但注意可能被代理污染 - 避免记录
r.URL.RawQuery或完整body—— 安全与性能双风险
多个中间件组合时,日志顺序容易乱
如果你用 Chain 函数组合中间件,要注意执行顺序:越靠前定义的中间件,越早进入、越晚退出。日志中间件通常应放在最外层(即最后被 Chain 包裹),否则可能漏掉 panic 恢复或 CORS 头设置产生的状态变化。
比如这个链:Chain(mux, recoverMiddleware, corsMiddleware, loggerMiddleware),loggerMiddleware 是最外层,它能看到最终响应;但如果把它放最里面,就看不到 recoverMiddleware 修改的状态码了。
真正的坑在于:panic 后 defer 不一定执行,所以恢复中间件必须在日志之前注册,且日志中间件内部不能 panic —— 否则整个链断裂,连错误都记不下来。


















