ShouldBindJSON 默认不忽略未知字段，多余字段会静默保留且可能泄露；可通过 json.Decoder.DisallowUnknownFields() 主动报错、binding:"-" 静默丢弃或 validator 自定义钩子实现白名单校验。
ShouldBindJSON 默认不忽略未知字段，多余字段会静默保留
Gin 的 ShouldBindJSON 底层用的是 json.Unmarshal，而标准库默认行为是「忽略未知字段」——但这个“忽略”只是不报错、不赋值，**字段名仍会被解析进 map，且若结构体有对应字段（哪怕没 tag），可能意外覆盖或干扰校验**。更关键的是：它**不会过滤掉多余字段本身**，这些字段会留在原始请求体里，后续若反射或日志打印结构体，可能暴露不该存在的数据。
- 比如前端传
{"name":"a","age":25,"token":"xxx"}，结构体只定义Name和Age，token不会报错，也不会被绑定，但如果你用reflect.ValueOf(req).NumField()查字段数，它还是 2；可一旦你把 req 转成 map 或打日志，token可能混进去 -
ShouldBind在Content-Type: application/json场景下等价于ShouldBindJSON，行为一致 - 没有开启
DisallowUnknownFields时，validator 也不会拦截多余字段——它只管已绑定字段的规则校验
用 json.Decoder.DisallowUnknownFields() 主动拒绝多余字段
最直接的办法是绕过 ShouldBindJSON，自己用 json.Decoder 控制解析行为。Gin 的 c.Request.Body 是可重用的，但注意：body 只能读一次，所以得先 io.ReadAll 缓存，再用 bytes.NewReader 构造新 reader。
- 示例代码片段：
body, _ := io.ReadAll(c.Request.Body)
c.Request.Body = io.NopCloser(bytes.NewReader(body))
dec := json.NewDecoder(bytes.NewReader(body))
dec.DisallowUnknownFields() // 关键：遇到未知字段立即报错
var req CreateUserReq
if err := dec.Decode(&req); err != nil {
c.AbortWithStatusJSON(400, gin.H{"error": "unknown field in JSON"})
return
}
- 这个方式能真正让多余字段触发错误，而不是放行
- 缺点是失去了 Gin 内置的 validator 校验集成，需手动调用
validate.Struct() - 别漏掉
c.Request.Body = io.NopCloser(...)，否则后续中间件或日志可能读不到 body
结构体字段加 binding:"-" 是最轻量的“逻辑过滤”
如果只是不想让某个字段参与绑定（比如前端误传了 id，但创建接口本不该接收），在结构体里显式禁用比改 decoder 更简单：
-
type CreateUserReq struct { ID int `json:"id" binding:"-"` Name string `json:"name" binding:"required"` }—— 这样id字段完全不参与绑定和校验，即使传了也当不存在 - 适用于已知哪些字段多余，且不需要报错，只要静默丢弃
- 注意：
binding:"-"对ShouldBindQuery同样生效，但对ShouldBindUri无效（路径参数必须绑定） - 不能靠它防恶意字段，只能算业务层约定过滤
validator 配合自定义 Hook 实现字段白名单校验
想在 validator 层统一拦截所有未声明字段？目前 go-playground/validator/v10 不支持原生白名单模式，但可通过 StructLevel 钩子 + 反射实现：
立即学习“go语言免费学习笔记（深入）”；
- 先用
json.Unmarshal解析到map[string]interface{}，拿到所有 key - 再遍历结构体字段，收集合法字段名（考虑
json:tag、字段名 fallback） - 对比 map keys 是否全在白名单内，不在就返回错误
- 这适合风控敏感场景，但增加了反射开销，不建议高频接口使用
真正需要严格过滤时，别依赖 ShouldBindJSON 的默认行为——它不负责安全边界，只负责尽力绑定。多余字段是否该报错、丢弃还是记录，得由你明确决定并编码落地。
