Go语言接口请求日志中间件如何实现-Golang-PHP中文网

直接用 log.println 打印请求日志会出问题，因为其无上下文隔离导致多请求日志混淆，且若中间件读取 r.body（如记录请求体），后续 handler 将因 body 已 eof 而无法读取。

go语言接口请求日志中间件如何实现

为什么直接用 `log.Println` 打印请求日志会出问题

因为 Go 的 HTTP handler 是并发执行的，log.Println 默认不带上下文隔离，多个请求的日志会混在一起，看不出哪条日志属于哪个请求；更严重的是，如果在中间件里读取了 r.Body（比如想记录请求体），后续 handler 就再也读不到它了——r.Body 是一次性流，读完就 EOF。

如何安全地记录请求方法、路径、状态码和耗时

核心是包装 http.ResponseWriter，拦截 WriteHeader 调用以捕获状态码，并用 time.Since 计算耗时。不需要碰 r.Body 或 r.Header，这些字段本身是安全可读的。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

用自定义结构体嵌入 http.ResponseWriter，重写 WriteHeader 方法，保存状态码并记录起始时间
避免在中间件里调用 r.ParseForm() 或 io.ReadAll(r.Body)，除非你明确要消费并重新构造 Body
注意：如果 handler 主动 panic，状态码可能没被写入，此时应 fallback 到 500

type loggingResponseWriter struct {
    http.ResponseWriter
    statusCode int
    start      time.Time
}

func (w *loggingResponseWriter) WriteHeader(code int) {
    w.statusCode = code
    w.ResponseWriter.WriteHeader(code)
}

func LoggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        lw := &loggingResponseWriter{
            ResponseWriter: w,
            start:          start,
        }
        next.ServeHTTP(lw, r)
        log.Printf("%s %s %d %v", r.Method, r.URL.Path, lw.statusCode, time.Since(start))
    })
}

要不要记录请求体和响应体？什么情况下可以开

记录请求/响应体不是默认选项，而是需显式开启的“高成本操作”。它会增加内存占用、延长延迟，并可能泄露敏感字段（如密码、token）。

只在调试环境开启，生产环境禁用 io.ReadAll 类操作
若必须记录，先检查 r.ContentLength 是否合理（比如 ），超限直接跳过
对响应体记录，必须用 io.TeeReader 或双写器（如 io.MultiWriter），不能简单替换 ResponseWriter 的 Write 方法——否则 gzip 等编码会被破坏
JSON 请求体可尝试用 json.RawMessage 解析后脱敏再记录，但别在中间件里做完整反序列化