嵌套结构体绑定失效主因是binding标签未写在正确层级：外层字段需加required确保非空，内层字段加具体规则，切片需dive，time.Time用datetime格式。
绑定嵌套结构体时字段不生效？检查 binding tag 是否写在正确层级
嵌套结构体绑定失败，最常见的原因是 binding 标签没写在最终要校验的字段上，而是写在了外层结构体字段声明处。Gin 的验证器（go-playground/validator/v10）只递归校验带 binding tag 的字段，且仅对导出字段（首字母大写）生效。
错误写法：
type Address struct {
City string `json:"city"`
Zip string `json:"zip"`
}
type User struct {
Name string `json:"name" binding:"required"`
Address Address `json:"address"` // ❌ 这里没加 binding，Address 内部字段不会被验证
}
正确写法：
type Address struct {
City string `json:"city" binding:"required,len=2|len=3"` // ✅ 验证逻辑写在内层
Zip string `json:"zip" binding:"required,numeric"`
}
type User struct {
Name string `json:"name" binding:"required"`
Address Address `json:"address" binding:"required"` // ✅ 外层也需标记 required，否则空对象会被跳过
}
-
binding:"required"加在外层结构体字段上，表示该嵌套对象本身不能为空（即不能是 nil 或全零值） - 内层字段的
binding规则才真正触发字段级校验 - 如果
Address是指针类型（*Address），binding:"required"表示指针非 nil；若为值类型，则要求所有字段满足其自身规则后整体才算“有效”
c.ShouldBind 无法复用 request body？用 ShouldBindJSON 替代通用 ShouldBind
当请求体是 JSON，但用 c.ShouldBind(&v) 绑定多维结构体时，可能因 Gin 自动推断绑定器失败而静默跳过验证，或报 EOF 错误。这是因为 ShouldBind 会根据 Content-Type 和 HTTP 方法尝试多种解析方式（form / query / json），在复杂嵌套场景下容易误判。
直接指定绑定器更可靠：
var req User
if err := c.ShouldBindJSON(&req); err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
-
ShouldBindJSON强制使用 JSON 绑定器，绕过自动推断逻辑，避免因 header 缺失或格式模糊导致的绑定失败 - 它内部调用的是
c.ShouldBindWith(&req, binding.JSON)，性能无差异，但语义明确 - 不要混用
ShouldBind和ShouldBindJSON对同一c.Request.Body—— Body 只能读一次，第二次会返回EOF
数组或切片字段校验失效？确保 binding tag 包含 elem 约束
结构体中定义了切片字段，比如 Tags []string，只写 binding:"required" 并不能校验每个元素，甚至可能让整个切片为空也不报错。
必须显式指定元素级约束：
type Post struct {
Title string `json:"title" binding:"required,min=1,max=100"`
Tags []string `json:"tags" binding:"required,gte=1,dive,required,min=1,max=20"`
}
-
dive是关键：它告诉 validator 进入切片/数组每个元素执行后续规则 -
gte=1表示切片长度至少为 1；required（配合dive）表示每个元素都不能为空字符串 - 若字段是
[]*Tag，dive同样适用，且会递归校验Tag内部字段 - 忘记
dive是生产环境最常被忽略的验证漏洞之一
自定义类型（如 time.Time）绑定失败？优先用 time_parse 而非手写 UnmarshalJSON
结构体含 time.Time 字段时，直接写 binding:"required" 往往报错 cannot parse time，因为默认 JSON 解析器不识别常见时间格式（如 "2024-01-01T12:00:00Z" 或 "2024-01-01"）。
Gin 原生支持时间格式解析，只需在 tag 中声明：
type Event struct {
Name string `json:"name" binding:"required"`
At time.Time `json:"at" binding:"required,datetime=2006-01-02T15:04:05Z07:00"`
// 或更宽松：datetime=2006-01-02
}
-
datetime=xxx是 validator 内置的时间解析规则，比自己实现UnmarshalJSON更轻量、更兼容 Gin 流程 - 格式字符串必须是 Go 的标准 layout（
"2006-01-02T15:04:05Z07:00"），不是 RFC3339 或 ISO8601 字面量 - 若需支持多种格式（如同时接受
"2024-01-01"和"2024-01-01T12:00:00"），得自定义 validator 函数，而非依赖 tag
多维结构体绑定不是单纯堆砌 tag，而是每一层、每一个切片、每一个时间字段都要主动声明约束意图。最容易漏掉的是 dive 和外层 required，它们不报语法错，却让验证形同虚设。
