c.ShouldBindJSON()绑定后字段全为零值，是因为请求体为空、Content-Type错误（如发了form-data却填JSON）、json tag拼写或大小写不匹配、字段未导出（首字母小写）或时间/布尔类型反序列化失败所致。
c.ShouldBindJSON() 是 Gin 解析 JSON 参数最常用、也最可控的方式，但它不是“一调就灵”的黑盒——出错时往往静默失败或 panic，根源几乎全在请求体或结构体定义上。
为什么 c.ShouldBindJSON() 绑定后字段全是零值？
这不是 Gin 没干活，而是它根本没找到可解析的数据，或解析中途放弃但没报错。
- 前端发的是
application/x-www-form-urlencoded（比如 Postman 选了 form-data 却填了 JSON 字符串），Gin 不会尝试 JSON 解析，直接跳过 body —— 结构体字段保持零值，err == nil - 请求体是空的（
{}）但结构体字段全是指针或非零默认值类型（如*string、time.Time），json.Unmarshal不会报错，只是不赋值 -
json:tag 写错（比如拼成josn:或大小写不一致），Gin 找不到对应字段，也不报错，只留零值 - 字段名首字母小写（如
name string），Go 反射无法导出，永远收不到数据
c.ShouldBindJSON() 和 c.BindJSON() 怎么选？
区别不在功能，而在错误发生时的控制权归属。
-
c.BindJSON()：失败时自动写400 Bad Request响应体（纯文本），并调用c.Abort()中断后续 handler 执行。别在它后面写日志或清理逻辑，那些代码永远不会运行 -
c.ShouldBindJSON()：只返回error，由你决定怎么处理——统一返回{"code":4001,"msg":"参数格式错误"}、记录原始 body、或做部分字段 fallback - 调试阶段建议先用
c.ShouldBindJSON()，加一行body, _ := io.ReadAll(c.Request.Body); fmt.Printf("raw: %s", body)，比猜快得多
结构体字段怎么写才真正生效？
JSON 绑定本质是 json.Unmarshal，Gin 只是封装入口。它不帮你纠错，只忠实地执行反射和 tag 匹配。
- 字段必须导出：首字母大写，如
Name string，不能是name string -
json:tag 值必须与前端传的 key 完全一致（包括下划线/驼峰、大小写），如前端传{"user_name":"alice"}，就得写Name string `json:"user_name"` - 时间字段别直接用
time.Time接字符串（如"2024-05-20"），会报cannot unmarshal string into Go struct field X.Time；改用string类型再手动 parse，或为字段实现UnmarshalJSON方法 - 布尔字段接收
"true"字符串会失败，JSON 必须是不带引号的true；若前端确实发字符串，需自定义反序列化逻辑
Content-Type 不对时还能救吗？
能，但得主动干预。Gin 的 ShouldBindJSON() 默认只信任 application/json 头，但你可以绕过它。
立即学习“go语言免费学习笔记（深入）”；
- 用
c.ShouldBindJSON()本身就能强制解析 body，不管 header 是啥 —— 如果 header 错了，它会明确报invalid character或EOF，而不是静默失败 - 如果要兼容多种格式（比如同时支持 JSON 和表单），别依赖
c.ShouldBind()自动判断，它容易选错解析器；改用显式组合：c.ShouldBindQuery(&q)+c.ShouldBindJSON(&p) - 调试时务必打印
c.GetHeader("Content-Type")，别信前端说“我设了”，实际网络链路中 header 可能被代理、网关或浏览器插件篡改
json: tag。 
