validator.struct() 总返回 nil 错误却校验失败，因其默认不递归校验嵌套结构体，且对零值/nil指针的判断高度依赖 tag 写法；需用 nonzero 区分非 nil 与非零值，嵌套字段显式加 structonly 或 dive，切片需配 min=1，time.time 校验应优先用 datetime 而非 time_format 避免 panic。
validator.Struct() 为什么总返回 nil 错误却校验失败
因为 validator.Struct() 默认不递归校验嵌套结构体字段，且对零值（如空字符串、0、nil 切片）是否触发规则高度依赖 tag 写法。常见现象是结构体看起来填了值，但 validate:"required" 仍报错——实际是字段类型为指针或接口，底层值仍是 nil。
- 用
validate:"required,nonzero"区分“非 nil”和“非零值”，比如*string类型必须加nonzero - 嵌套结构体必须显式加
validate:"required,structonly"（structonly表示只校验本层，不自动下钻）或validate:"required,dive"（dive才会进入子字段） - 切片/Map 字段若要求非空，不能只写
required，得配min=1或len=1，否则空切片[]也被视为“存在”而通过required
time.Time 类型的 time_format 校验为何总是 panic
validator 对 time.Time 的 datetime 或 time_format 校验不是靠反射解析字段值，而是依赖 time.Parse()。一旦 tag 中格式串与实际传入字符串不匹配（比如后端接收的是 RFC3339 但写了 time_format="2006-01-02"），就会在 ValidateStruct 阶段直接 panic，而不是返回错误。
- 统一用
datetime而非time_format，它内置支持 RFC3339、ISO8601、Unix timestamp 等多种格式 - 如果必须自定义格式，确保字符串值和 tag 完全一致，例如
time_format:"2006-01-02T15:04:05Z07:00"对应"2024-05-20T10:30:00+08:00" - 避免在结构体字段上直接声明
time.Time接收字符串请求参数；应先用string类型接收，再手动time.Parse并赋值，校验逻辑与解析逻辑分离
自定义错误消息怎么绑定到具体字段而不全局覆盖
全局注册 RegisterTranslation 会让所有同 tag 字段共用一条提示，但实际需要按字段给不同提示（比如 Username 和 Email 都用了 required，但提示语不同）。validator 不支持字段级消息内联定义，只能靠 FieldError 的上下文动态生成。
- 不要用
RegisterTranslation("required", ...)全局替换，改用err.(validator.ValidationErrors)类型断言后遍历每个FieldError - 根据
fe.Field()字段名查 map，例如map[string]string{"Username": "用户名不能为空", "Email": "邮箱格式不正确"} - 注意：若结构体用了匿名嵌入（embedding），
fe.Field()返回的是嵌入字段名（如Password），但fe.StructNamespace()才是完整路径（如User.Password），需提前约定命名策略
validator.New() 的选项影响哪些行为
默认初始化的 validator.New() 实例不开启 ValidateNonStruct，也不处理 nil 指针解引用，导致对 *User 类型变量调用 Struct() 时直接 panic，而非返回错误。
立即学习“go语言免费学习笔记（深入）”；
- 生产环境务必启用
validator.WithRequiredStructEnabled(true)，否则required对指针字段无效 - 需要校验独立变量（如单个
string或int）时，必须用ValidateVar()并传入WithNilPointerCheck(true) - 禁用
ValidateEmpty（默认开启）可跳过零值字段的 tag 解析，提升小对象校验性能，但会忽略min=1这类约束
