Golang与Gin框架实现多层敏感字段隐藏输出-Golang-PHP中文网

因为json标签只在直接调用json.marshal时生效，对interface{}、指针nil、嵌套结构体及orm返回的map[string]interface{}无效，且子结构体标签不自动继承，无法保障动态数据脱敏安全。

golang与gin框架实现多层敏感字段隐藏输出

敏感字段为什么不能只靠结构体标签过滤

因为 json 标签（如 json:"-" 或 json:"name,omitempty"）只在直接调用 json.Marshal 时生效，而 Gin 的 c.JSON 内部确实用了它——但问题出在嵌套结构体、指针字段、map 或 interface{} 类型上。一旦某层是 interface{}（比如从数据库查出后未强转），json 标签就完全失效；同理，指针字段为 nil 时若没加 omitempty，仍可能输出 null，反而暴露字段存在性。

别依赖 json:"-" 处理动态数据或 ORM 返回的 map[string]interface{}
嵌套结构体中，子结构体字段的 json 标签不会被父级自动继承，必须每一层都显式声明
Gin 的 c.ShouldBindJSON 不会校验输出字段，只管入参解析；隐藏逻辑必须在响应前完成

用自定义 MarshalJSON 实现可控脱敏

对敏感结构体实现 MarshalJSON 方法，是最直接且类型安全的方式。它绕过默认反射逻辑，由你完全控制哪些字段序列化、如何处理空值或加密替换。

例如用户模型需隐藏 Password 和 IDCard：

func (u User) MarshalJSON() ([]byte, error) {
    type Alias User // 防止无限递归
    return json.Marshal(&struct {
        *Alias
        Password string `json:"password,omitempty"`
        IDCard   string `json:"id_card,omitempty"`
    }{
        Alias:    (*Alias)(&u),
        Password: "******",
        IDCard:   u.maskIDCard(),
    })
}

必须用 type Alias User 避免方法递归调用自身
字段名保持原结构体大小写，否则 JSON key 会变（如 Password → password）
如果字段是指针（如 *string），需判空再赋值，否则解引用 panic
该方法仅对值接收者有效；若用指针接收者，c.JSON(200, &u) 才触发

Gin 中间件统一拦截响应体做字段擦除

当项目已有大量结构体、又无法修改其定义时，中间件 + 字段路径匹配是更灵活的选择。核心是劫持 ResponseWriter，在写入前对 body 做 JSON Patch 或字段删除。

Golang Samber Do

使用 samber/do 在 Golang 中实现依赖注入 — 服务容器、生命周期管理、作用域、健康检查、优雅关闭和模块组织

下载

推荐用 github.com/tidwall/gjson 解析 + github.com/tidwall/sjson 修改，避免反序列化全量结构：

func SanitizeMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        rw := &responseWriter{ResponseWriter: c.Writer, body: &bytes.Buffer{}}
        c.Writer = rw
        c.Next()
        if c.Writer.Status() == 200 && strings.Contains(c.Writer.Header().Get("Content-Type"), "application/json") {
            data := rw.body.Bytes()
            // 删除 user.password、user.profile.phone 等路径
            cleaned, _ := sjson.DeleteBytes(data, "user.password")
            cleaned, _ = sjson.DeleteBytes(cleaned, "user.profile.phone")
            c.Writer.WriteHeader(c.Writer.Status())
            c.Writer.Write(cleaned)
        }
    }
}