嵌套结构体validate不生效，首要检查字段是否导出（首字母大写），嵌套结构体本身也须导出；指针字段用omitempty跳过nil校验，内部字段单独加required；StructLevel校验需显式调用StructCtx并注册。
嵌套结构体里 validate 标签不生效？检查字段是否导出
Go 的 validator 库（如 go-playground/validator/v10）只能校验**导出字段**（首字母大写）。如果嵌套结构体的字段是小写，比如 type User struct { name string }，即使加了 validate:"required" 也不会被检查——库根本读不到这个字段。
实操建议：
- 所有需校验的嵌套字段必须首字母大写，例如
Name、Address、Profile - 嵌套结构体本身也必须是导出类型（
type Address struct而非type address struct） - 若想保持 JSON 字段小写但校验有效，用
json标签单独控制序列化：Name string `json:"name" validate:"required"`
StructLevel 校验如何触发？必须手动调用 StructCtx
普通 Validate.Struct() 不会自动执行 StructLevel 钩子。如果你写了类似「密码和确认密码必须一致」这种跨字段逻辑，只加 validate:"eqfield=ConfirmPassword" 不够，还必须注册 StructLevel 函数并显式使用 Validate.StructCtx()。
常见错误现象：嵌套结构体里的 StructLevel 完全没被调用，校验静默通过。
实操建议：
- 注册时用
v.RegisterStructValidation(YourFunc, YourStructType)，注意传入的是类型（不是实例） - 调用校验时必须用
v.StructCtx(ctx, obj)，不能用Struct() - 在
StructLevel函数内，用sl.Current().Interface()获取当前嵌套实例，再做字段比对
嵌套指针字段为空时，required 和 omitempty 怎么配合？
当嵌套字段是 *Address 类型，且该指针为 nil，validate:"required" 会直接报错；但如果你希望它“可选”，又要求非空时内部字段必须合法，就不能只靠 required。
典型场景：API 请求中 User 可带 Address，也可不带；但如果带了，Address.Street 就必须非空。
实操建议：
- 嵌套指针字段用
validate:"omitempty"跳过nil检查 - 在嵌套结构体内部字段上加校验，如
Street string `validate:"required"` - 避免对指针字段同时写
required,omitzero——omitzero对指针无效，nil不是 zero value - 若需“非 nil 时才校验整个嵌套结构”，可用自定义函数 +
StructOnly标签
性能敏感时，Validate.Struct() 重复调用嵌套结构体怎么办？
默认行为下，每次调用 Validate.Struct() 都会对每个嵌套结构体重新反射解析标签、构建校验规则树。如果一个请求要校验几十个 User 实例，而每个 User 都含 Profile 和 Settings，开销会明显上升。
关键点在于：校验器实例（*validator.Validate）本身是线程安全且可复用的，但默认不缓存嵌套结构体的校验器。
实操建议：
- 初始化时调用
v.RegisterValidation(...)和v.RegisterStructValidation(...)一次即可 - 避免在 handler 内反复
validator.New()，复用全局单例 - 对高频嵌套结构体，可提前调用
v.CachedStructDescriptor(reflect.TypeOf(MyStruct{}))手动预热（v10.12+ 支持） - 不要在循环里对同一结构体类型反复调用
Struct()—— 提前校验好再批量处理
最易被忽略的是嵌套结构体字段的导出性与指针语义的组合：既想保持 API 兼容（JSON 小写），又要让 validator 看得见字段，还得正确处理 nil 场景。这三个条件叠在一起，少一个就会在校验逻辑里埋下静默失败的坑。
