最轻量可控的HTTP请求日志方式是自定义loggingResponseWriter拦截WriteHeader和Write以捕获状态码与响应长度，并在中间件中记录方法、路径、状态码、耗时及可信客户端IP，同时禁用http.Server.DebugPrint和默认错误日志避免干扰。
用 http.Handler 包裹原始 handler 实现请求日志
最轻量、最可控的方式是写一个中间件式 wrapper，不依赖第三方库，直接操作 http.ResponseWriter 和 *http.Request。关键点在于：必须用自定义的 ResponseWriter 拦截状态码和响应体长度，否则只能记录请求而无法获取真实 HTTP 状态。
- 不能只靠
log.Printf打印r.Method和r.URL.Path就完事——这漏掉了状态码、耗时、客户端 IP 等关键字段 - 需嵌入
http.ResponseWriter接口所有方法（Write、WriteHeader、Flush等），并在WriteHeader中捕获最终状态码 - 客户端真实 IP 要从
r.Header.Get("X-Forwarded-For")或r.RemoteAddr取，但注意反向代理场景下前者可能被伪造，建议结合TrustedProxies过滤
type loggingResponseWriter struct {
http.ResponseWriter
statusCode int
written 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.written += n
return n, err
}
func LoggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
lrw := &loggingResponseWriter{
ResponseWriter: w,
statusCode: 0,
}
next.ServeHTTP(lrw, r)
clientIP := r.Header.Get("X-Forwarded-For")
if clientIP == "" {
clientIP = strings.Split(r.RemoteAddr, ":")[0]
}
log.Printf("[%s] %s %s %d %dms %s",
time.Now().Format("2006/01/02 15:04:05"),
r.Method,
r.URL.Path,
lrw.statusCode,
int(time.Since(start).Milliseconds()),
clientIP,
)
})
}
避免在 net/http 日志中重复打印 panic 堆栈
默认 http.Server 在 handler panic 时会调用 log.Panic 输出到标准错误，如果你已在 middleware 里 recover 并自定义了错误日志，就容易出现双份 panic 日志，干扰排查。
- 显式设置
http.Server.ErrorLog为nil或自定义log.Logger，防止底层自动打堆栈 - 在 middleware 的
defer/recover中统一处理 panic，并记录完整堆栈（用debug.PrintStack()或runtime/debug.Stack()） - 不要在 recover 后简单
log.Print错误字符串——它不含文件名和行号，定位困难
使用 chi/middleware.Logger 时注意字段缺失问题
chi/middleware.Logger 默认只输出方法、路径、状态码和耗时，不包含客户端 IP、User-Agent、Referer 等常用字段，且日志格式固定、不易扩展。
- 它内部用
ctx.Value存储 request ID，但不会自动注入 X-Request-ID header，需配合chi/middleware.RequestID - 若要加 Client IP，得自己 wrap 一次：从
r.Context().Value(chi.RouteCtxKey)拿不到 IP，必须从r本身取 - 它的日志输出走
log.Printf，无法对接zap或zerolog等结构化日志库，高并发下有性能损耗
生产环境务必关闭 http.Server.DebugPrint
Go 1.22+ 引入了 http.Server.DebugPrint 字段，默认为 true，会在启动时打印路由树；但更隐蔽的是，它还会在每次 404 或方法不匹配时往 os.Stderr 写调试信息——这在容器环境中常被误当成应用错误日志收集，造成告警噪音。
立即学习“go语言免费学习笔记（深入）”；
- 显式设为
false：srv := &http.Server{DebugPrint: false, ...} - 该字段不影响你自己的日志逻辑，但和
log.Printf混在一起时极难区分来源 - 如果用了
gin或echo等框架，它们的 debug mode 也会开启类似行为，需单独关掉
日志格式里时间戳精度、状态码捕获时机、客户端 IP 的可信来源，这三处最容易出偏差。别假设 r.RemoteAddr 总是真实 IP，也别相信任何中间件默认就填全了你要的字段。