validator不支持嵌套结构体零值自动跳过校验，需用omitempty配合required；指针类型nil时跳过子校验，普通struct即使全零也会校验；应优先用validate.struct()并预先判空；时间校验需用string字段配合datetime规则，而非直接校验time.time。
validator 包（如 go-playground/validator）本身不支持嵌套结构体的零值自动跳过校验，必须显式用 omitempty 标签控制，否则空对象也会触发内部字段校验失败。
为什么 required 在嵌套字段里总报错？
常见现象是：父结构体字段为指针或可为空，但子结构体字段加了 required，一传空对象就校验失败。这是因为 validator 默认对非 nil 的嵌套结构体做深度校验，不管它实际有没有值。
解决方式不是删掉 required，而是配合 omitempty 使用：
-
omitempty必须和required同时存在，且顺序无关（如validate:"required,omitempty"） - 仅对指针、接口、map、slice、chan、func 类型有效；普通 struct 字段即使为空也会被校验
- 如果字段是
*Child类型，nil时跳过整个子校验；如果是Child类型，哪怕全零值也会进子结构体校验
示例：
type Request struct {
Name string `validate:"required"`
Child *Child `validate:"omitempty"` // ✅ nil 时跳过
}
type Child struct {
Age int `validate:"required,gte=0"`
}
Validate.Struct() 和 Validate.Var() 该选哪个？
本质区别在于上下文是否完整：前者能识别结构体字段标签并递归校验嵌套，后者只校验单个值，无法感知所属结构体的 omitempty 等逻辑。
典型误用场景：
- 把
*Request传给Validate.Var()→ 只校验指针是否为 nil，不会跑字段校验 - 想单独校验某个字段（比如从 map 动态取值），才用
Validate.Var(value, "required,email") - HTTP 请求绑定后统一校验，一律用
Validate.Struct(req)，哪怕 req 是指针
注意：Validate.Struct() 对 nil 指针会 panic，务必先判空：
if req == nil {
return errors.New("request is nil")
}
err := validate.Struct(req)
自定义错误信息怎么绑定到具体字段？
validator 默认返回的 ValidationErrors 是一个 slice，每个元素含 Field()、Tag()、Value() 等方法，但不直接带中文提示。硬编码 switch 匹配 Field() + Tag() 容易漏、难维护。
更可靠的做法是用 RegisterTranslation() 配合 Translate()：
- 先注册字段级翻译（如
"User.Name.required"→ "用户名不能为空"） - 调用
errs.Translate(trans)得到 map[string]string，key 是Field()值 - 避免用
error.Error()直接输出，那只是调试字符串，不含结构化字段名
关键点：翻译 key 的格式是 "{Struct}.{Field}.{Tag}"，大小写需与结构体字段名完全一致。
时间字段校验为什么总是 invalid value？
validator 本身不解析时间字符串，time.Time 字段只能校验其零值（比如 IsZero()），不能校验 "2024-01-01" 这种字符串格式是否合法。
正确做法分两步：
- 接收层用
string字段 +validate:"required,datetime=2006-01-02"（注意格式必须匹配 Go time layout） - 校验通过后再用
time.Parse()转成time.Time，不要在结构体里直接定义time.Time并加required -
datetime内置规则只支持有限几种 layout，自定义格式要注册RegisterCustomTypeFunc()
否则你会看到看似莫名其妙的 "Key: 'Request.StartTime' Error:Field validation for 'StartTime' failed on the 'required' tag" —— 其实是 string 转 time 失败导致字段变零值，被 required 拦下。
最常被忽略的是：validator 不处理类型转换，只做值校验。所有解析、赋值、默认值填充，都得在调用 Validate.Struct() 之前完成。
