结构体联动校验必须用 RegisterStructValidation 注册 StructLevel 回调，因 eqfield 仅做字符串级相等比较、不处理 nil 指针/类型差异/未导出字段，且错误提示不可定制；正确做法是显式取值判空、类型安全比较并主动 ReportError。
结构体联动校验在 Go 中无法靠 validate tag 自动完成，必须用 StructLevel 注册回调函数，否则“密码和确认密码一致”这类跨字段逻辑永远不生效。
为什么 required 和 eqfield=Password 都不解决联动问题
很多人试过写 Password string `validate:"required"` 和 ConfirmPassword string `validate:"required,eqfield=Password"`，但发现 eqfield 在嵌套或指针字段下失效、错误信息不明确、甚至 panic。根本原因是：eqfield 只做字段值字符串级相等比较，不校验类型一致性，也不处理 nil 指针或未导出字段；它更像一个快捷语法糖，不是联动校验的可靠方案。
真正需要联动判断的场景（如“开始时间不能晚于结束时间”“支付金额必须等于订单总金额”），必须脱离字段级 tag，进入结构体层面控制流程。
-
eqfield不检查字段是否可访问：若Password是小写字段，eqfield=Password直接静默跳过，不报错也不校验 -
eqfield不处理类型差异：比如一边是string，一边是int，比较会失败但错误提示是 “cannot compare”，而非业务语义错误 -
eqfield无法定制错误码或本地化文案，所有提示都固定为英文且不可替换
用 RegisterStructValidation 写安全的联动校验
正确做法是注册 StructLevel 回调，在里面显式取值、判空、类型断言、逻辑比较，并调用 sl.ReportError 主动上报。
立即学习“go语言免费学习笔记（深入）”；
关键点不是“怎么写逻辑”，而是“怎么避免 panic”：
- 始终先调用
sl.Current().Interface()获取结构体实例，再做类型断言，不要直接对sl.Field下手 - 对每个可能为 nil 的字段（尤其是指针或嵌套结构体）加
if v == nil判断，别假设它一定非空 - 用
v.Kind() == reflect.String替代v.Interface().(string)，防止类型断言 panic - 错误字段名传
"Password"而不是"ConfirmPassword"，让错误定位指向源头而非验证方
示例：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
validate.RegisterStructValidation(func(sl validator.StructLevel) {
u := sl.Current().Interface().(User)
if u.Password == "" || u.ConfirmPassword == "" {
sl.ReportError(u.Password, "Password", "Password", "password_required", "")
return
}
if u.Password != u.ConfirmPassword {
sl.ReportError(u.Password, "Password", "Password", "password_mismatch", "")
}
}, User{})
联动校验必须配合字段导出与非 nil 入参
哪怕 StructLevel 写得再严谨，以下两点任一不满足，整个校验就静默失效：
- 结构体字段必须首字母大写：如
Password string，不是password string；否则sl.Current().Interface().(User)能拿到值，但字段本身为零值，联动逻辑基于假数据运行 - 传给
Validate.Struct()的必须是非 nil 指针：如&user，不是user或nil；否则sl.Current()返回空reflect.Value，后续.Interface()panic - 如果结构体含嵌套指针字段（如
Profile *UserProfile），需在StructLevel回调里额外判空：if u.Profile != nil && u.Profile.Age < 0，否则直接访问u.Profile.Agepanic
Gin 中联动校验容易漏掉的注册时机
在 Gin 里用 c.ShouldBind 或 c.Bind 触发校验时，StructLevel 必须提前注册到 Gin 内部持有的 validator 实例上，而不是你本地 new 出来的那个。
错误写法：validator.New().RegisterStructValidation(...) —— 这个实例 Gin 根本不用。
正确写法（必须在 gin.Default() 之后、路由注册之前）：
r := gin.Default()
v := binding.Validator.Engine().(*validator.Validate)
v.RegisterStructValidation(yourCallback, User{})
漏掉这一步，Gin 绑定时完全无视你的 StructLevel，也不会报错，只会按默认规则走字段级校验，联动逻辑彻底丢失。
最常被忽略的是：联动校验不自动递归。即使你在 User 上注册了回调，它的子结构体 Address 字段若也有联动需求，必须单独为 Address 再注册一次 StructLevel，不能指望父级回调覆盖子级。
