默认 http.ServeMux 不记录日志因其仅负责路由分发,无内置日志逻辑;需通过中间件包装 Handler,在 ServeHTTP 前后捕获请求与响应信息,注意用自定义 ResponseWriter 获取真实状态码和耗时。

为什么默认的 http.ServeMux 不记录请求日志
Go 标准库的 http.ServeMux 本身不带日志功能,它只负责路由分发,所有请求都静默透传。你看到的 http.ListenAndServe 启动后“没反应”,不是卡了,是真没输出——连 GET /health 这种探针请求都不会打一行日志。
要加日志,必须自己套一层中间件(即包装 http.Handler),在调用下游 Handler.ServeHTTP 前后读取请求/响应信息。
用 log.Printf 写最简中间件要注意什么
最轻量的做法是写一个闭包函数,返回 http.Handler,但得小心几个坑:
- 不能直接读
ResponseWriter的状态码和字节数——标准http.ResponseWriter没暴露这些字段 - 必须用
http.Hijacker或自定义 wrapper 才能捕获真实响应状态,否则日志里全是 0 或 200 -
time.Now()要在ServeHTTP开始时记一次,结束时再算耗时,别用defer里的时间差(可能不准)
示例(可直接用):
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
lw := &responseWriter{ResponseWriter: w, statusCode: 200} // 默认假设成功
next.ServeHTTP(lw, r)
log.Printf("%s %s %s %d %dms",
r.Method,
r.URL.Path,
r.Proto,
lw.statusCode,
int(time.Since(start).Milliseconds()))
})
}
type responseWriter struct {
http.ResponseWriter
statusCode int
}
func (rw *responseWriter) WriteHeader(code int) {
rw.statusCode = code
rw.ResponseWriter.WriteHeader(code)
}
用 net/http/httputil.DumpRequest 记完整请求体是否可行
可以 dump,但不推荐在生产环境默认开启,原因很实际:
-
httputil.DumpRequest(r, true)会读取r.Body,导致后续 handler 拿不到原始 body(io.EOF) - 大文件上传、JSON 流式解析等场景下,dump 会吃光内存或阻塞连接
- 敏感字段(如
Authorization、Cookie)会明文落盘,审计过不了
如果真要 debug,建议只对特定路径(如 /debug)或加开关控制,并用 r.Body = ioutil.NopCloser(bytes.NewReader(bodyBytes)) 恢复 body。
第三方库如 gorilla/handlers 的 LoggingHandler 怎么配
gorilla/handlers 提供开箱即用的 LoggingHandler,但它默认只打访问行(类似 Apache common log),不包含耗时、响应体大小等关键字段。
- 它底层也是用自定义
ResponseWriter包装,所以状态码和字节数能准确拿到 - 日志格式由
handlers.CommonLoggingHandler的Logger控制,可传入*log.Logger自定义输出目标(比如写到文件或 syslog) - 注意它不兼容 Go 1.22+ 的
http.Handler新接口(如http.HandlerFunc直接赋值),需确保类型一致
典型用法:
import "github.com/gorilla/handlers"
logFile, _ := os.OpenFile("access.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
handler := handlers.LoggingHandler(logFile, myMux)
http.ListenAndServe(":8080", handler)
真正难的是把耗时、traceID、用户身份这些上下文塞进同一行日志——那得自己组合 middleware 链,或者换用 zerolog/zap + context 传递。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











