validator默认不支持字段间逻辑校验，因其设计为单字段驱动，内置标签仅作用于当前字段值；跨字段业务规则（如“status为active时end_time必填”）必须通过RegisterStructValidation注册结构体级校验函数，手动取值并调用sl.ReportError触发错误。
为什么 validator 默认不支持“字段间逻辑校验”
因为 validator（如 go-playground/validator/v10）设计上是单字段驱动的，所有内置标签（required、min=10、email）都只看当前字段值。一旦需要“如果 status 是 "active"，则 end_time 必须非空”，它就无能为力——这不是字段自身约束，而是业务规则。
常见错误现象：StructLevel 注册后没生效、Validate.Struct() 返回 nil 但逻辑没跑、自定义函数里取不到其他字段值。
- 必须用
Validate.RegisterStructValidation()显式注册结构体级校验函数，不能只写函数 - 校验函数签名必须是
func(sl validator.StructLevel)，且内部要通过sl.Current().Interface()取出整个 struct 实例 - 不要在 struct tag 里写类似
gtfield=end_time这种不存在的标签——那是老版本或误传，v10 已移除
怎样用 RegisterStructValidation 实现“状态与时间互锁”逻辑
比如一个任务结构体：Status 为 "completed" 时，CompletedAt 必须有值；为 "pending" 时，CompletedAt 必须为空。
实操关键点在于：结构体级校验函数里，你拿到的是当前 struct 的反射对象，可自由读取任意字段，但必须手动调用 sl.ReportError() 触发失败，否则 validator 不知道出错了。
立即学习“go语言免费学习笔记（深入）”；
func taskStructLevelValidation(sl validator.StructLevel) {
task := sl.Current().Interface().(Task)
if task.Status == "completed" && task.CompletedAt.IsZero() {
sl.ReportError(task.CompletedAt, "completed_at", "CompletedAt", "completed_at_required", "")
}
if task.Status == "pending" && !task.CompletedAt.IsZero() {
sl.ReportError(task.CompletedAt, "completed_at", "CompletedAt", "completed_at_forbidden", "")
}
}
// 注册一次即可，通常放在 init() 或服务启动处
validate := validator.New()
validate.RegisterStructValidation(taskStructLevelValidation, Task{})
-
sl.ReportError()第二个参数（"completed_at"）要和 struct tag 中的字段名一致（如json:"completed_at"），否则错误信息里的字段名会错乱 - 若结构体嵌套多层，
sl.Current()拿到的是最内层 struct，不是根结构体——注意作用域 - 性能影响小，但别在里面做 DB 查询或 HTTP 调用；校验函数应纯内存操作
如何让 validator 复用已有字段规则并叠加逻辑
结构体级校验不会自动触发字段级规则（比如 CompletedAt json:"completed_at" time.Time `validate:"required"`）。所以得手动组合：先让字段级规则跑完，再补业务逻辑。
推荐做法是：字段 tag 保留基础约束（required、datetime 等），结构体级函数只处理跨字段依赖。这样既复用生态，又避免重复判断。
- 例如
CompletedAt仍加validate:"required"，但仅当Status=="completed"时才应触发——这时就得在结构体校验里先检查Status，再决定是否“放行”字段级校验结果 - 更稳妥的做法是去掉字段级
required，全由结构体级控制，避免 validator 内部提前报错打断流程 - 如果要用
validate:"omitempty"配合逻辑判断，注意零值行为：time.Time 的零值是0001-01-01，不是 nil，omitempty对它无效
为什么 CustomTypeFunc 和 RegisterValidation 不适合这类场景
有人试图用 RegisterValidation("status_dependent") 给单个字段加 tag，然后在函数里去查其他字段——这行不通。自定义字段验证函数接收的只有当前字段的 reflect.Value，拿不到 struct 上下文。
错误示例：CompletedAt time.Time `validate:"status_dependent"` → 函数里根本访问不到 Status 字段。
-
RegisterValidation适用于字段自身衍生规则（比如校验字符串是否是某类 UUID 格式），不跨字段 -
CustomTypeFunc是为自定义类型（如type Email string）提供统一解析逻辑，和字段关系无关 - 真正需要跨字段，唯一正解就是
RegisterStructValidation+ 手动取值 + 手动报错
最容易被忽略的一点：校验函数注册必须在所有 validate 调用之前完成，且全局唯一。如果在 handler 里反复 New validator 并注册，不仅浪费，还可能因竞态导致部分注册丢失。
