Go HTTP中间件字段脱敏唯一可靠路径是包装http.ResponseWriter实现Write拦截并流式解析JSON，基于key路径（如user.phone）脱敏，配合struct tag（如secure:"phone,mask"）声明规则，兼顾类型安全与性能。
Go HTTP 中间件对响应体做字段脱敏
直接改 http.ResponseWriter 的输出是唯一靠谱的路径，别试图在 handler 返回前“修改结构体字段”——那对已序列化的 JSON 无效，也拦不住第三方库直写 response。
常见错误现象：json.Marshal 后手动字符串替换，结果把数字、URL、嵌套 JSON 里的同名字段也干掉了；或者用反射遍历 struct 打标记，但没处理指针、interface{}、自定义 marshaler，一碰 time.Time 或 sql.NullString 就 panic。
- 用
io.TeeReader或包装http.ResponseWriter实现拦截，推荐后者：实现Write([]byte)方法，在写入前解析 JSON 字节流（注意只处理Content-Type: application/json） - 脱敏逻辑必须基于 key 路径（如
user.phone），不能只看字段名；否则address.phone和user.phone会混淆 - 性能敏感场景下避免每次解析完整 JSON，可用
json.Decoder.Token()流式读取，匹配到目标 key 后跳过值（用skip()）并注入占位符
struct tag 控制字段可导出性与脱敏规则
Go 没有运行时字段权限，json: tag 是最轻量、最可控的声明入口。别用注释或外部配置文件管理脱敏规则——同步成本高、IDE 不提示、编译期零校验。
使用场景：同一 struct 在不同 API 接口返回不同字段粒度，比如管理后台返回完整 User，App 端只暴露 id 和 nickname。
立即学习“go语言免费学习笔记（深入）”；
- 定义新 tag，例如
secure:"phone,mask"或perm:"read:admin"，比复用json:更语义清晰 - 反射读 tag 时务必检查
!field.CanInterface()，私有字段无法取地址，reflect.Value.Interface()会 panic - 注意嵌套结构体的 tag 继承：如果
User.Profile是指针类型且为 nil，反射访问会空指针，需提前判空
gin / echo 等框架中集成字段级权限控制
框架本身不提供字段权限，所谓“集成”其实是把脱敏逻辑塞进统一的响应包装层。gin 的 Context.JSON 不能直接 hook，得替换为自定义方法，比如 c.SecureJSON(code, data)。
容易踩的坑：在 middleware 里调用 c.Next() 后再读 response body，但 gin 默认不 buffer 响应体，此时 ResponseWriter 已 flush，拿不到内容。
- 必须在 handler 执行前就替换
c.Writer，用gin.ResponseWriter的Write()和WriteHeader()方法拦截 - 权限判断不能只依赖用户角色字符串，要解析 token claim 或查 DB 得到具体字段白名单，比如
["user.id", "user.email"]，而非笼统的"user:read" - error 响应也要脱敏：
500 Internal Server Error的 detail 字段可能含路径、数据库表名，需统一过滤error结构体的Message和Stack
脱敏后 JSON 格式与兼容性风险
字段脱敏不是简单替换成 "***"，它直接影响下游解析逻辑。前端若按原字段类型做类型断言（比如 number），你返回字符串就会崩。
性能影响常被低估：每个响应都做 JSON 解析 + 修改 + 重序列化，QPS 上千时 CPU 明显上涨，尤其含大数组或深层嵌套结构时。
- 优先用类型保持策略：手机号脱敏为
"138****1234"（字符串），身份证号脱敏为"110101****00001234"（仍是字符串），避免把int64强转成string导致前端 Number() 失败 - 对数值型字段（如余额）脱敏要谨慎，不能返回字符串，建议保留数字类型并设为
0或null，由业务约定语义 - 测试时必须覆盖
nil字段、空 slice、含 emoji 的字符串、base64 编码字段——这些地方 JSON 解析器容易误判边界
字段级权限真正的复杂点不在技术实现，而在于规则如何和业务生命周期对齐：API 版本升级、新字段上线、权限策略动态变更……这些时候 tag 写死或硬编码的白名单最容易漏掉同步。
