应根据Content-Type选择：JSON请求用ShouldBindJSON，表单/上传用ShouldBind；混用会导致静默失败或误导性错误；binding:"required"失效常见于null转空字符串、字段未导出、绑定方式与数据格式不匹配。
ShouldBind 和 ShouldBindJSON 到底该选哪个
别硬记规则，看请求头 Content-Type：如果是 application/json，必须用 ShouldBindJSON；如果是 application/x-www-form-urlencoded 或 multipart/form-data，用 ShouldBind 更稳。两者底层绑定器不同，混用会静默失败——比如用 ShouldBindJSON 去解析表单，err 可能是 invalid character '-' in numeric literal 这类误导性错误，实际只是格式不匹配。
常见误区是以为 ShouldBind 能“自动识别一切”，但它只对表单和查询参数做智能推断，对 JSON 会直接跳过解析逻辑，导致结构体字段全为零值，还不报错。
-
ShouldBindJSON：严格校验 JSON 语法 + 结构体标签 + binding 规则 -
ShouldBind：先尝试表单解析，再 fallback 到查询参数，不处理 JSON -
ShouldBindQuery：只从 URL 查询字符串（?a=1&b=2）提取，无视请求体
binding:"required" 失效的三种典型场景
加了 binding:"required" 却没拦住空请求？大概率掉进了这三个坑：
- 字段类型是
string但传了null—— JSON 解析后变成空字符串""，而required不校验空字符串，得补min=1或自定义验证器 - 结构体字段没导出（首字母小写），Gin 绑定器根本看不到它，直接跳过，
binding标签形同虚设 - 用了
ShouldBind但请求是 JSON，或用了ShouldBindJSON但 body 是空/非法 JSON，此时err是解码错误，不是验证失败，required根本没机会触发
验证是否生效，最直接的办法是打印 err.Error()，看提示里有没有 Key: 'X.Field' Error:Field validation for 'Field' failed on the 'required' tag 这类明确指向 binding 的信息。
立即学习“go语言免费学习笔记（深入）”；
错误定位时别只看 err.Error()
err 是 validator.ValidationErrors 类型时，err.Error() 只返回第一处失败，掩盖其他问题。真要定位，得强转并遍历：
if err := c.ShouldBindJSON(&req); err != nil {
if errs, ok := err.(validator.ValidationErrors); ok {
for _, e := range errs {
fmt.Printf("field=%s rule=%s value=%v\n", e.Field(), e.Tag(), e.Value())
}
return
}
c.JSON(400, gin.H{"error": err.Error()})
return
}
这样能一次性看到所有字段的违规详情，比如 username 空、email 格式错、age 超范围，不用反复改请求重试。
注意：这个技巧只对 binding 标签触发的验证有效；如果是手动 if req.X == "" 判空，得自己构造错误信息。
URI 参数和 Query 参数混用时的绑定冲突
当路由是 /user/:id?name=xxx，同时用 ShouldBindUri 和 ShouldBindQuery，容易漏字段或覆盖值。更稳妥的做法是合并在一个结构体里，用对应标签区分来源：
type UserRequest struct {
ID int64 `uri:"id" binding:"required"`
Name string `form:"name" binding:"required"`
}
// 然后用 ShouldBind 而非 ShouldBindUri + ShouldBindQuery 组合
if err := c.ShouldBind(&req); err != nil { ... }
ShouldBind 在这种混合场景下会自动合并 URI、Query、Form 数据，按标签取源，避免手动拼接出错。但前提是标签名（如 uri:"id"）和字段名一致，否则取不到值。
容易忽略的一点：如果 URI 参数是字符串（如 /user/:uid），但结构体字段声明为 int64，绑定会失败且报错模糊，建议优先用 string 接收再手动转换，或确保前端传数字格式。
