shouldbind 和 mustbind 不能混用，因请求体（如 json）只能读取一次，二者均会消耗 c.request.body；先调用 shouldbind 后再调用 mustbind 将因 eof 导致 panic。
为什么 ShouldBind 和 MustBind 不能混用
同一个请求体（如 JSON）只能被读取一次，ShouldBind 和 MustBind 都会调用 c.Request.Body 的 Read 操作。如果先调用 ShouldBind 失败后又调用 MustBind，后者会读到空数据，触发 EOF 错误并 panic。
实操建议：
- 只选一种：参数校验必须强约束就用
MustBind；需要自定义错误响应或降级逻辑就用ShouldBind - 若用
ShouldBind，务必检查返回的error，不要忽略 - 避免在中间件和 handler 中重复绑定同一结构体
如何让 binding:"required" 对 query 参数生效
Gin 默认对 Query 参数不启用 struct tag 校验，即使写了 binding:"required" 也不会报错。必须显式指定绑定目标为 form 或 query。
实操建议：
- Query 参数需用
c.ShouldBindQuery(&v)或c.ShouldBind(&v)配合binding:"query,required" - 结构体字段 tag 写成
query:"name" binding:"required"才能触发校验 -
c.ShouldBind默认行为取决于 Content-Type：JSON 请求走json，application/x-www-form-urlencoded走form，?a=1&b=2这类纯 querystring 必须用ShouldBindQuery
嵌套结构体绑定时 binding:"required" 不生效怎么办
Gin 的默认绑定器（StructValidator）不会递归校验嵌套结构体字段，外层字段即使设了 required，内层字段为空也不会报错。
实操建议：
- 给嵌套字段加上
binding:"required"，且确保该字段类型不是指针（指针类型为空时不会触发校验） - 更可靠的方式是使用
github.com/go-playground/validator/v10替换默认校验器，并开启Validate.Struct的Recursive选项 - 简单场景下，手动校验嵌套字段非空：
if v.Nested == nil || v.Nested.ID == 0 { ... }
ShouldBindJSON 报错 invalid character 的常见原因
这个错误通常不是 JSON 格式问题，而是请求头缺失或错误：Content-Type: application/json 没传、传成了 text/plain，或者前端用 JSON.stringify 但没通过 fetch 的 body 正确发送。
实操建议：
- 用 curl 测试：
curl -X POST -H "Content-Type: application/json" -d '{"name":"a"}' /api - 前端确认是否设置了
headers: {"Content-Type": "application/json"} - 后端加日志：在绑定前打印
c.GetHeader("Content-Type")和c.Request.ContentLength - 不要依赖
c.ShouldBind自动识别格式 —— 明确用c.ShouldBindJSON并确保 header 正确
