本文详解如何通过自定义响应写入器（responsewriter）在 gin 中拦截并记录响应体，适用于错误日志、调试审计等场景，并提供可直接运行的中间件实现及关键注意事项。
本文详解如何通过自定义响应写入器（responsewriter）在 gin 中拦截并记录响应体，适用于错误日志、调试审计等场景，并提供可直接运行的中间件实现及关键注意事项。
在 Gin 中，c.Writer 默认不暴露已写入的响应体内容，因此无法直接通过 c.Writer.Body() 获取——这是因为 Gin 的 ResponseWriter 实现仅负责向底层 http.ResponseWriter 写入数据，本身不缓存内容。若需记录响应体（尤其是错误响应），必须在写入过程中主动拦截并缓冲数据。核心思路是：实现一个包装型 ResponseWriter，重写 Write() 方法，在将字节写入原始响应器的同时，同步写入内存缓冲区（如 bytes.Buffer）。
以下是一个生产就绪的中间件示例：
package main
import (
"bytes"
"fmt"
"github.com/gin-gonic/gin"
)
// bodyLogWriter 包装 gin.ResponseWriter，用于捕获响应体
type bodyLogWriter struct {
gin.ResponseWriter
body *bytes.Buffer
}
// Write 拦截所有写入操作：同时写入原始响应器和内部缓冲区
func (w bodyLogWriter) Write(b []byte) (int, error) {
w.body.Write(b)
return w.ResponseWriter.Write(b)
}
// ginBodyLogMiddleware 记录状态码 ≥400 的响应体（含 JSON、文本等）
func ginBodyLogMiddleware() gin.HandlerFunc {
return func(c *gin.Context) {
// 创建带缓冲区的包装写入器
blw := &bodyLogWriter{
ResponseWriter: c.Writer,
body: bytes.NewBufferString(""),
}
c.Writer = blw
// 执行后续处理链（路由处理、其他中间件等）
c.Next()
// 仅对错误响应记录响应体（可根据需要调整条件）
if statusCode := c.Writer.Status(); statusCode >= 400 {
// 注意：blw.body.String() 是 UTF-8 安全的字符串；若响应体含二进制数据，建议用 []byte 处理
fmt.Printf("[ERROR] %d %s | Response Body: %s\n",
statusCode,
c.Request.Method+" "+c.Request.URL.Path,
blw.body.String())
}
}
}
使用方式非常简洁：
func main() {
r := gin.Default()
r.Use(ginBodyLogMiddleware()) // 注册中间件
r.GET("/error", func(c *gin.Context) {
c.JSON(500, gin.H{"error": "internal server error"})
})
r.Run(":8080")
}
⚠️ 重要注意事项：
- 静态文件不生效：Gin 对 Static 等静态资源服务使用底层 http.ServeFile，绕过 c.Writer，因此该中间件无法捕获静态文件响应体。如需全面覆盖，需在 http.ListenAndServe 层级封装整个 gin.Engine 为 http.Handler，并对其 ResponseWriter 做全局拦截（见原答案延伸方案）。
- 性能与内存开销：响应体被完整缓存至内存，对大文件或流式响应（如文件下载、长连接）可能导致高内存占用甚至 OOM。生产环境建议限制记录条件（如仅限 Content-Type: application/json 或响应体大小
- 并发安全：bytes.Buffer 本身非并发安全，但 Gin 中每个请求由独立 goroutine 处理，且 bodyLogWriter 实例作用域限于单个请求，因此无需额外加锁。
- 字符编码兼容性：blw.body.String() 返回 UTF-8 字符串，适用于绝大多数 Web 响应；若需处理 GBK 等编码，应在写入缓冲区前做转码。
总结：该方案以最小侵入性实现了响应体可观测性，是 Gin 日志增强的通用实践。务必结合业务场景评估缓存策略，并在高负载服务中做好容量监控。
