嵌套结构体字段未绑定是因JSON标签缺失或类型不匹配，需显式声明层级、使用指针类型、确保键名大小写一致，并用ShouldBindJSON和打印验证。
嵌套结构体字段没被绑定？检查标签是否写对了
Gin 默认用 json 标签解析请求体，但嵌套结构体必须显式声明层级关系，否则字段会静默忽略。常见错误是只写 json:"name"，没处理内层嵌套。
- 外层结构体字段类型必须是结构体指针（
*Address）或值类型（Address），不能是interface{}或map[string]interface{} - 内层结构体字段也要带
json标签，且名字需与 JSON 键完全匹配（区分大小写） - 如果嵌套字段允许为空，推荐用指针类型，避免零值覆盖（比如
*string而非string）
示例：
type User struct {
Name string `json:"name"`
Addr *Address `json:"address"`
}
type Address struct {
City string `json:"city"`
Zip string `json:"zip"`
}
Gin.BindJSON 为什么返回 nil error 却没绑定数据？
这通常不是 Gin 的 bug，而是 JSON 键名和结构体标签不一致，或者嵌套字段类型不匹配导致绑定失败但不报错 —— Gin 默认跳过无法映射的字段，也不提示。
- 用
c.ShouldBindJSON()替代c.BindJSON()，它不会自动 Abort，便于你手动检查绑定结果 - 绑定后立刻打印结构体，确认字段是否为零值：
fmt.Printf("%+v", user) - 注意 JSON 中的
null：若字段是值类型（如string），null会被忽略；若为指针（如*string），则设为nil - 别忘了
Content-Type: application/json请求头，缺失时 Gin 会跳过 JSON 绑定逻辑
想支持嵌套数组或 map 怎么写结构体？
数组和 map 都能直接嵌套，但要注意初始化和空值处理逻辑。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
立即学习“go语言免费学习笔记（深入）”；
- 数组用切片：
Orders []Order `json:"orders"`，Gin 会自动分配 slice 空间 - map 必须指定键类型，推荐
map[string]string或map[string]interface{}；但后者无法做类型安全校验，慎用 - 如果 JSON 中该字段可能缺失或为
null，建议用指针：*[]Order或*map[string]string - 深层嵌套（如
[][]map[string]*float64）虽语法合法，但可读性和调试成本陡增，优先拆成命名结构体
绑定失败时如何拿到具体错误位置？
Gin 的默认错误信息太笼统，比如 Key: 'User.Addr.City' Error:Field validation for 'City' failed on the 'required' tag，但不会告诉你原始 JSON 哪里不对。
- 启用验证器（如
go-playground/validator/v10）并自定义错误翻译，能定位到具体字段 - 临时加一层日志：在 Bind 前用
ioutil.ReadAll(c.Request.Body)读取原始字节（注意 Body 只能读一次，需用c.Request.Body = ioutil.NopCloser(bytes.NewReader(data))复原） - 开发期可用
curl -H "Content-Type: application/json" -d @data.json http://localhost:8080/user配合fmt.Printf("raw: %s", data)对比结构 - 别依赖前端传来的字段顺序 —— JSON 解析不保证顺序，结构体字段顺序无关紧要
嵌套 JSON 绑定本身不难，难的是排查“看似成功实则丢失字段”的情况。最稳妥的做法：每次新增嵌套字段，都写一个最小 JSON 示例 + 打印输出验证，而不是等联调时才发现 city 总是空字符串。
