ShouldBind会静默失败，因它仅返回error而不终止请求，需手动检查err并响应；若忽略，非法参数将导致后续panic或数据错乱，正确做法是立即用c.AbortWithError或c.JSON返回错误。
为什么 Gin 的 ShouldBind 会静默失败？
因为 ShouldBind 在校验失败时只返回错误，但不终止请求处理逻辑——你得自己判断并响应。很多人写了校验结构体、调了 ShouldBind，却没检查返回的 err，结果参数非法也继续往下走，导致后续 panic 或数据错乱。
正确做法是：每次调用后立刻检查 err，并用 c.AbortWithError 或手动 c.JSON 返回错误。Gin 不会自动拦截非法请求。
- 别写
if err := c.ShouldBind(&req); err != nil { /* 忽略 */ } - 必须写
if err := c.ShouldBind(&req); err != nil { c.AbortWithError(http.StatusBadRequest, err)； return } -
ShouldBind默认使用json标签，不是form或uri，传参方式不同要换方法（见下一条）
ShouldBindJSON、ShouldBindQuery、ShouldBindUri 怎么选？
参数来源决定绑定方法，选错会导致字段全为零值或直接报 Key: '' Error:Field validation for '' failed 这类模糊错误。
- POST/PUT 请求体是 JSON → 用
ShouldBindJSON - GET 查询参数（
?page=1&size=10）→ 用ShouldBindQuery - URL 路径参数（
/user/:id）→ 先在路由定义里写:id，再用ShouldBindUri绑定到 struct 字段上，且字段 tag 必须是uri:"id" - 表单提交（
Content-Type: application/x-www-form-urlencoded）→ 用ShouldBind（它会根据 Content-Type 自动选），或显式用ShouldBindWith(&req, binding.Form)
混用会失效：比如用 ShouldBindJSON 去解析 query 参数，必然报错且无提示。
自定义校验规则怎么加进 binding？
Gin 底层用的是 go-playground/validator/v10，所有 struct tag 都走它。想加手机号、邮箱、范围限制，直接写 validator tag 即可，不用额外注册。
示例：
type CreateUserReq struct {
Name string `json:"name" binding:"required,min=2,max=20"`
Email string `json:"email" binding:"required,email"`
Age int `json:"age" binding:"required,gte=0,lte=150"`
}
- 内置规则够用：
required、email、url、min/max、len、gte/lte - 自定义函数需调用
validator.RegisterValidation，但多数场景不需要——先用内置规则，不够再扩展 - tag 名必须和绑定方式一致：
json:"name"对应ShouldBindJSON，form:"name"对应表单绑定
嵌套结构体或 slice 参数校验容易漏什么？
嵌套字段默认不递归校验。比如 User 里有个 Profile *Profile 字段，即使 Profile 有 binding:"required"，ShouldBind 也不会校验它内部字段，除非显式加 dive。
- 嵌套结构体加
dive：Profile *Profile `json:"profile" binding:"dive"` - slice 元素校验也要
dive：Tags []string `json:"tags" binding:"required,dive,required,min=1,max=20"` - 空指针不会触发
dive—— 如果Profile是 nil，dive直接跳过，不会报错。需要额外判空逻辑 - 数组长度校验写在 slice 字段本身（如
gt=0），元素内容校验才放dive后面
没加 dive 是嵌套校验失效最常见原因，错误现象是外层字段有值、内层字段全零但无报错。
