StructLevel 校验需在 validator 实例初始化后立即注册，使用 fl.ReportError 精准报错，避免 panic；Gin 中须在 gin.Default() 后、路由前注册到 binding.Validator.Engine()；动态条件应抽离为函数或通过 Functional Options 注入，不可硬编码或写入 tag；dive 遇 nil 指针静默跳过，必配 required 保障非空校验。
直接用 validator.RegisterStructValidation，别碰 eqfield 或硬编码 if 判断——它不支持动态条件、无法注入上下文、并发不安全，且错误定位模糊。
StructLevel 校验函数必须在 validator 实例初始化后注册
你写了个校验函数，但 Validate.Struct() 完全没调用它？大概率是注册时机错了。Gin 默认的 binding.Validator.Engine() 和你自己 validator.New() 创建的是两个独立实例。
- 若用 Gin，必须在
gin.Default()之后、任何路由注册前，调用binding.Validator.Engine().(*validator.Validate).RegisterStructValidation(...) - 若不用 Gin，自己管理 validator 实例，则必须在
v := validator.New()后立即注册，且后续所有校验都复用这个v - 注册时第二个参数必须是具体结构体类型（如
UserForm{}），不是指针也不是接口，否则反射找不到目标
StructLevel 函数里不能直接 panic，必须用 fl.ReportError()
常见错误是写成 if u.Password != u.ConfirmPwd { panic("mismatch") }，这会让 validator 捕获 panic 并转为泛化错误，丢失字段上下文，前端无法精准提示“确认密码不一致”。
-
fl.CurrentStruct.Interface()返回的是interface{}，需强制断言为具体指针类型，例如(*UserForm) - 报错必须调
fl.ReportError(u.Password, "ConfirmPwd", "confirm_pwd", "password_mismatch")：第一个参数是字段值（用于取原始值），第二个是字段名（用于定位），第三个是 JSON tag 名（用于前端映射），第四个是自定义 error tag（用于 i18n） - 同一个结构体可注册多个 StructLevel 函数，它们会按注册顺序依次执行，不短路
动态条件校验得靠传参或闭包，别塞进 struct tag
比如“仅当 Status == "draft" 时才校验 Deadline”，如果把逻辑硬写死在 StructLevel 函数里，就丧失了复用性，也难以测试。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 推荐做法：把条件判断抽成独立函数，如
func shouldValidateDeadline(status string) bool，在校验函数内调用 - 更灵活的方式是用 Functional Options 构造 validator 实例，把运行时参数（如当前状态、租户 ID）注入进去，避免全局变量和并发污染
- 绝对不要试图在 struct tag 里写
validate:"deadline_if_draft=Status"——validator 不解析这种语法，也不会传参，纯属无效标签
嵌套结构体 + nil 指针是静默跳过校验的重灾区
写成 Profile *UserProfile `validate:"required,dive"`，但请求里没传 profile 字段，Profile 就是 nil，整个 UserProfile 校验直接被跳过，连 required 都不触发。
- 若字段允许为空但非空时需校验，用
dive是对的；但若业务上要求该字段必须存在，就得加required标签，且确保反序列化后不是 nil - JSON 解析时，
*struct类型字段若缺失，会保持为nil；而struct类型会初始化为零值，此时dive才生效 - 调试时可用
reflect.ValueOf(u.Profile).IsNil()快速确认是否被跳过
真正难的不是写校验逻辑，而是让 StructLevel 函数能拿到稳定、干净、带上下文的数据——这意味着你要控制好反序列化顺序、空值处理、指针初始化，以及 validator 实例的生命周期。漏掉其中一环，错误就会变成“校验没生效”这种无头苍蝇问题。
