Gin框架日志脱敏自定义中间件-Golang-PHP中文网

gin 中无法通过单一中间件自动脱敏请求和响应日志，必须分离处理：请求体脱敏在 c.next() 前完成并重置 r.body，响应体脱敏需包装 c.writer 在 c.next() 后操作，且两者逻辑完全隔离。

gin框架日志脱敏自定义中间件

直接说结论：Gin 里没法靠中间件“自动”脱敏请求日志，必须拆开做——请求体脱敏在 c.Next() 前，响应体脱敏在 c.Next() 后但需包装 c.Writer，且两者逻辑完全隔离。

因为请求体和响应体的读取时机、方式、生命周期完全不同：

请求体 r.Body 是单次可读流，io.ReadAll(r.Body) 后后续 handler（比如 c.ShouldBindJSON()）就拿不到数据了，必须重设 r.Body = bytes.NewReader(buf) 并同步更新 r.ContentLength 和 Content-Length header
响应体默认不缓存，c.Writer 一旦调用 WriteHeader() 或首次 Write()，数据就直发 TCP，中间件里根本拿不到原始 JSON 字节
中间件无结构体语义，password 字段可能叫 pwd、auth_token、userSecret，仅靠字符串匹配会误杀或漏杀

否则绑定逻辑已消费 body，你再读就是空的。关键点不是“能不能读”，而是“读完怎么还回去”：

Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载，版本号 1.9.0，适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载

开头加 r.Body = http.MaxBytesReader(c.Writer, r.Body, 1024*1024) 防 OOM，上限按业务定（如 1MB）
跳过 GET 请求：if c.Request.Method == "GET" { goto skipBody }，避免读空 body 报错
对 application/json：用 json.Unmarshal 解析成 map[string]interface{}，递归遍历 key，命中敏感键（如 "password"、"token"、"idCard"）且 value 类型为 string 时替换为 "***"
对 application/x-www-form-urlencoded 或 multipart/form-data：优先调 c.Request.ParseForm()，再遍历 c.Request.PostForm，别手动解析
脱敏后要同步更新 c.Request.URL.RawQuery（query 参数）和 c.Request.Header（如 Authorization），否则日志里看到的是未脱敏原始值

不能等 c.Next() 结束再去读 c.Writer——它没暴露缓冲区。正确做法是提前替换：

定义结构体实现 http.ResponseWriter 接口，内嵌原 c.Writer，并持有一个 bytes.Buffer
重写 Write([]byte)：把数据先写进 buffer，不直接透传；重写 WriteHeader(int)：缓存状态码
在 c.Next() 后检查 c.Request.Header.Get("Content-Type") 是否含 "application/json"，是则从 buffer 取出字节，json.Unmarshal → 脱敏 → json.Marshal → 再调原 Write()
非 JSON 类型（如 text/html、image/png）直接透传，避免破坏静态资源或文件下载
注意：脱敏后的响应体长度可能变化，需重置 Content-Length header，否则客户端收不到完整数据

字段名变形太常见（pwd、api_key、user_secret），靠 strings.Contains(key, "pass") 必踩坑：

敏感键列表从配置文件加载，支持正则，例如 ^.*(?:pwd|pass|token|key|secret|card|phone|id).*
结合路径和 method 做白名单控制：只对 POST /api/v1/login、PUT /api/v1/profile 等接口脱敏，GET /api/v1/users 不处理响应体中的 phone
query 参数脱敏也需路径判断：/api/v1/orders?token=xxx 要脱，但 /health?check=db 不脱
结构体字段脱敏不要指望中间件——该用 json:",omitempty" + 自定义 MarshalJSON 方法，或 zap 的 MarshalLogObject 接口