gin参数绑定不是自动合并的，shouldbind默认只处理body，query需shouldbindquery、path需shouldbinduri或c.param，且结构体字段必须加对应tag（如json:"x"、form:"x"、uri:"x"），content-type错误或缺失会导致shouldbindjson报invalid content type。
直接说结论：Gin 的参数获取不是“一锅炖”，ShouldBind 不会自动合并 query、body 和 path，结构体字段没加对应标签就绑定不上，路径参数 c.Param("id") 必须手动取 —— 这些是 90% 的人踩坑的起点。
ShouldBindJSON 为什么报错 invalid content type？
这不是 JSON 解析失败，而是请求头根本没带 Content-Type: application/json。Gin 严格按 header 判断绑定器类型，哪怕 body 是合法 JSON，header 缺失或写成 text/plain 都会触发这个错误。
- 检查 curl 命令是否漏了
-H "Content-Type: application/json" - 前端 fetch 要显式设置
headers: { "Content-Type": "application/json" } -
ShouldBindJSON只读 body，完全忽略 URL 查询参数（如?page=1），别指望它填进去 - 结构体字段必须带
json:"field_name"标签，否则字段值为空，不报错但数据丢了
Query 参数和表单参数怎么一起绑定？
ShouldBind 看请求方法和 Content-Type 自动选绑定器，但它不会把 query 和 form 合并 —— 它只处理 body（form-data 或 x-www-form-urlencoded），query 参数默认被忽略。
- 想同时收 query 和 form，结构体字段得同时声明
form:"name"和form:"name"（注意：query 绑定实际用的是form标签，Gin 没有独立的query标签） - 更清晰的做法是分开调：
c.ShouldBindQuery(&q)拿查询参数，c.ShouldBind(&f)拿表单，再手动合并逻辑 - GET 请求没有 body，
ShouldBind会退化为只尝试解析 query，但前提是字段有form标签；没标签就啥也拿不到
路径参数 :id 怎么进结构体？
Gin 从不自动把 /user/:id 里的 :id 塞进任何 ShouldBindXXX 结构体。这是独立通道，必须手动取。
- 路由定义要明确：
r.GET("/user/:id", handler)，不能写成/user/:id?（无效语法） - 在 handler 里用
c.Param("id")拿字符串，再自己转类型：id, _ := strconv.ParseInt(c.Param("id"), 10, 64) - 如果想让结构体也接收路径参数，得用
ShouldBindUri，且结构体字段必须带uri:"id"标签，且路由变量名和标签名要一致 - 多个路径参数（如
/a/:x/b/:y）必须分别调c.Param("x")和c.Param("y")，没有批量 API
binding:"required" 为什么没生效？
校验只在绑定成功后触发。如果字段类型不匹配（比如 JSON 传了字符串，结构体字段是 int），绑定阶段就失败了，校验根本没机会跑。
- 确保字段类型与传入数据一致：JSON 里
"age": "25"对应string，不是int -
binding:"required"只对空值校验（""、0、nil），不防类型错 - 错误类型可区分：
errors.Is(err, binding.ErrUnknown)是字段不存在，errors.Is(err, binding.ErrInvalid)是类型或格式错 - 路径参数、header、query 都支持 binding 标签，但必须配合对应绑定方法（
ShouldBindUri、ShouldBindHeader、ShouldBindQuery）
最易被忽略的一点：Gin 的绑定器是“按需加载”的，没用到的字段标签（比如写了 json 但用了 ShouldBindQuery）完全不起作用，也不会警告 —— 数据静默丢失。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
