线上Go日志中间件状态码丢失、耗时不准、panic日志不全的根本原因是未包装http.ResponseWriter及未正确处理WriteHeader调用时机;必须通过statusRecorder拦截WriteHeader和Write以捕获真实状态码、累计响应体大小,并确保耗时统计终点为Write/WriteHeader返回,且Recovery需在日志中间件外层。

Go 日志中间件写出来不难,但线上一跑就漏状态码、耗时不准、日志重复或 panic 崩溃——根本原因不是逻辑错,而是没包装 http.ResponseWriter,也没处理好 WriteHeader 调用时机。
为什么简单打印 r.Method 和 r.URL.Path 不够用
只在 next.ServeHTTP 前后打日志,会丢失关键信息:真实响应状态码(比如业务里写了 w.WriteHeader(404) 但你日志里记成 200)、响应体大小、准确耗时(time.Since 必须在 Write 或 WriteHeader 完成后才算真正结束)。更严重的是,如果下游 panic,next.ServeHTTP 没执行完,后置日志就永远不触发。
- 状态码必须从被包装的
ResponseWriter中捕获,不能靠“默认 200”硬猜 - 响应体大小要拦截
Write方法,累计字节数 - 耗时统计起点是请求进入,终点是
Write或WriteHeader返回,不是next.ServeHTTP返回 - 若中间件链里有
Recovery,它必须在日志中间件外层,否则 panic 时日志写不全
statusRecorder 包装器怎么写才不出错
直接嵌套 http.ResponseWriter 接口,重写 WriteHeader 和 Write,把状态码和字节数存到结构体字段里。注意两个易错点:WriteHeader 可能被调用多次(虽然规范不建议),Write 可能在没调 WriteHeader 时被先调(此时隐式为 200)。
type statusRecorder struct {
http.ResponseWriter
status int
size int
}
func (r *statusRecorder) WriteHeader(code int) {
if r.status == 0 {
r.status = code
}
r.ResponseWriter.WriteHeader(code)
}
func (r *statusRecorder) Write(b []byte) (int, error) {
if r.status == 0 {
r.status = http.StatusOK
}
n, err := r.ResponseWriter.Write(b)
r.size += n
return n, err
}
- 不要在
WriteHeader里直接赋值r.status = code,要加r.status == 0判断,防重复覆盖 -
Write方法里也要补默认状态码,因为有些 handler 只调Write不显式设状态码 - 别忘了把
size累加到结构体字段,而不是局部变量
注册顺序决定日志能不能看到真实状态码
日志中间件必须比 Recovery 更靠近业务 handler,否则 panic 被 recover 捕获后,statusRecorder 已经失效,状态码记成 0。典型安全顺序是:Recovery → Logging → Auth → 业务 handler。
- 错误写法:
http.Handle("/api", logging(recovery(handler)))—— recovery 在最里层,panic 后 logging 拿不到响应信息 - 正确写法:
http.Handle("/api", recovery(logging(handler)))—— recovery 处理完 panic,再交由 logging 记录最终结果 - 如果用了
http.NewServeMux(),同样要用srvMux.Handle,不能用srvMux.HandleFunc,后者不接受已包装的http.Handler
要不要用第三方库?看这三点再决定
标准库足够写一个生产级日志中间件,引入 alice 或 gorilla/handlers 主要省掉手动链式调用,但会掩盖底层细节,出问题时更难定位。
- 项目只有 2–3 个中间件,手写
Chain函数更可控,比如:Chain(handler, logging, auth, recovery) - 需要结构化日志(JSON 输出)、对接 Loki 或 Prometheus,
gorilla/handlers.LoggingHandler可快速接入,但它的statusRecorder实现较老,不支持自定义字段 - 团队刚转 Go,优先手写一遍,理解
ResponseWriter包装原理,比抄配置重要得多
真正卡住人的从来不是怎么写日志,而是状态码从哪来、耗时算到哪一秒、panic 发生时日志还剩多少没刷出去——这些都得扣到 WriteHeader 和 Write 的调用路径里去验证。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











