shouldbind不适用于纯json请求体，因其依赖content-type自动选解析器，缺失或错配时会静默fallback至form/query导致绑定错乱；shouldbindjson严格要求application/json，否则报错，字段须带json标签，错误类型为json.unmarshaltypeerror。
别用 ShouldBind 处理纯 JSON 请求体——它会因 Content-Type 缺失或错配而静默 fallback 到 query 或 form，导致字段绑定错乱，调试时极难定位。
ShouldBindJSON 必须配合 application/json
它只认 Content-Type: application/json，其他类型（比如空、text/plain、甚至 application/json;charset=utf-8）都会直接返回错误。这不是 bug，是设计上的严格性保障。
- 前端发请求时漏设 header →
c.ShouldBindJSON立即报invalid content type - Postman 里选了 “JSON” 但没点 “Send as JSON” → 实际发的是
application/x-www-form-urlencoded→ 绑定失败 - 结构体字段必须带
json标签，否则即使数据存在也不会赋值（form标签在此无效） - 若需兼容
charset后缀，可提前在中间件 normalize header：c.Request.Header.Set("Content-Type", "application/json")
ShouldBindQuery 只读 URL 查询参数，不碰 body
它完全忽略请求体（无论 JSON 还是 form），只解析 r.URL.Query()。适合 GET 接口的分页、筛选等场景。
- 结构体字段用
form标签，不是json—— 即使你后续也用它接收 POST 的 query 参数 - 支持默认值：如
Page int `form:"page,default=1"`，当 URL 无page时自动设为 1 - 不校验字段是否“必须”，
binding:"required"在ShouldBindQuery中被忽略；如需必填校验，得手动检查或换用ShouldBind+ 表单提交 - 中文参数要确保前端
encodeURIComponent，否则 Gin 解析可能乱码或截断
ShouldBind 是“自动模式”，但优先级规则很关键
它根据 Content-Type 选解析器，但字段匹配时始终优先使用 form 标签 —— 即使你发的是 JSON，只要结构体同时定义了 form 和 json 标签，form 就赢。
- GET 请求：只看
form标签，无视json标签 - POST 且
Content-Type: application/json：仍先找form标签；只有字段没form标签时，才退回到json标签 - 一个字段同时写
form:"user" json:"user"→ JSON 请求也走form解析逻辑，可能出错（例如字段名大小写不一致） - 想彻底避免歧义？删掉所有
form标签，改用ShouldBindJSON或ShouldBindQuery显式指定来源
ShouldBind 和 ShouldBindJSON 错误处理差异极大
ShouldBind 返回的 error 类型是 validator.ValidationErrors（如果用了 binding tag），而 ShouldBindJSON 出错时通常是 json.UnmarshalTypeError 或 json.SyntaxError，二者不能用同一套错误格式化逻辑处理。
-
ShouldBindJSON失败基本意味着客户端数据格式非法（如字段类型错、JSON 不合法），适合快速返回 400 + 原始错误信息 -
ShouldBind失败更可能是业务校验失败（如binding:"required"未满足），适合提取具体字段和验证规则做用户友好提示 - 混用两者时，不要共用同一个 error handler —— 否则
json.SyntaxError被当成 validator 错误去遍历FieldError，会 panic - 生产环境建议对
ShouldBindJSON做 recover 包裹，防止 malformed JSON 导致 panic（Gin 默认不 recover）
最易被忽略的一点：ShouldBind 的“自动”本质是妥协，它在开发初期省事，但在多端协作、前后端分离项目中，反而增加隐性耦合——谁也不知道这次请求到底从哪读的字段。明确用 ShouldBindJSON、ShouldBindQuery 或 ShouldBindUri，才是长期可维护的起点。
