自定义验证器不生效的根本原因是注册时机错误或类型断言失败；必须在gin.default()后立即注册，通过binding.validator.engine().(*validator.validate)获取实例并校验ok值，确保名称大小写一致、不重复注册，且函数签名严格为func(fl validator.fieldlevel) bool。
自定义验证器不生效，大概率是注册时机或类型断言失败，不是代码写错了。
注册自定义验证器必须在 gin.Default() 之后、任何路由前
binding.Validator.Engine() 返回的是懒加载单例，gin.Default() 才真正初始化它。放在 init() 函数里、或者写在某个 handler 里，都会拿到 nil 或未初始化的实例。
- 正确位置：main 函数开头，
r := gin.Default()下一行就调用注册逻辑 - 必须做类型断言：
v, ok := binding.Validator.Engine().(*validator.Validate)，ok为 false 就别往下走了 - 重复注册同名 tag 会 panic，加个
if !v.HasRegisteredNamespace("my_tag")防御 - 标签名大小写敏感，
binding:"phoneCN"和注册的"phonecn"不匹配
验证函数签名和返回值不能错
函数必须严格是 func(fl validator.FieldLevel) bool，多一个参数、少一个参数、返回 error 或 string 都会导致静默失效——Gin 不报错，也不调你函数。
- 用
fl.Field().Interface()取原始值，再根据类型断言（比如.(string)），别直接fl.Field().String()吃 panic - 返回
false表示校验失败，Gin 会自动收集进ValidationErrors；返回true表示通过 - 不要在函数里
log或panic，Gin 不捕获，可能直接 crash 进程 - 需要参数（如
phone=CN）就用fl.Param()解析，它返回等号后全部内容，自行strings.SplitN
嵌套结构体里 eqfield 失效？不是 bug，是作用域限制
validate:"eqfield=Password" 默认只在**当前 struct 层级**找字段，不会向上穿透到父结构体。比如 User.Profile.Password 中的 Profile 是嵌套 struct，eqfield=Password 在 Profile 里找不到 Password 就直接失败。
- 解决办法：改用结构体级别验证器，在
ValidateStruct里手动取user.Password和profile.RePassword比对 - 或者把字段提到同一层，比如
Password和RePassword都放在顶层Userstruct 里 - 别依赖
eqfield跨层级，它的设计本就不支持
错误信息怎么映射成前端友好的 JSON
Gin 的 c.ShouldBind() 错误是 validator.ValidationErrors 类型，但默认返回的是 Key/Field/Tag 拼接的字符串，前端没法直接消费字段名和错误码。
- 用
errors.As(err, &ve)判断是否为*validator.InvalidValidationError，再从ve.Err提取validator.ValidationErrors - 遍历每个
FieldError，用fe.Field()（对应 JSON key，如"user_name"）而非fe.StructField()（对应 Go 字段名UserName） - 查表映射错误码和中文提示，比如
"password_username_conflict"→"密码不能包含用户名" - 别用
c.Error()或c.AbortWithStatusJSON(400, ...)直接塞原始 err，它不解析 validator 错误
最易忽略的点：validator 实例是全局单例，但注册动作不可逆，调试时反复启停服务容易因重复注册 panic；上线前务必确认注册逻辑只执行一次，且早于所有绑定操作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
