自定义验证器不生效的主因是注册时机错误或类型断言失败：必须在 gin.Default() 后、任何 handler 前注册，且需先做 *validator.Validate 类型断言并加防重复注册判断，tag 名须严格一致，验证函数签名固定为 func(fl validator.FieldLevel) bool。
自定义验证器写好了但 binding:"my_tag" 不生效？不是代码逻辑错，大概率是注册时机或类型断言失败——Gin 的 validator 实例在首次 ShouldBind 才初始化，init() 里直接调 binding.Validator.Engine() 常返回 nil。
注册自定义验证器必须在 gin.Default() 之后、任何 handler 启动前
validator 实例是懒加载的，binding.Validator.Engine() 在没触发过绑定时可能为 nil。别信 init()，它跑得太早；也别塞进 handler 里，它跑得太晚。
- 正确位置：
main()函数开头，r := gin.Default()下一行就做注册 - 必须先做类型断言：
v, ok := binding.Validator.Engine().(*validator.Validate)，否则 panic - 加防御性判断：
if !v.HasRegisteredNamespace("chinese_mobile")，避免重复注册导致 panic - tag 名严格区分大小写：
binding:"chinese_mobile"和注册的"chinese_mobile"必须完全一致
RegisterValidation 的函数签名和参数限制
传给 v.RegisterValidation() 的验证函数签名固定为 func(fl validator.FieldLevel) bool，不能改参、不能返回 error、不能 panic——失败就 return false。
-
fl.Field().String()是最安全取值方式；若字段是 int/bool 等，用fl.Field().Interface()再类型断言 - 不要在验证函数里调
c.Abort()或写响应——它只负责“对/错”，错误组装由 Gin 统一处理 - 正则校验建议预编译：
var mobileRe = regexp.MustCompile(<code>^1[3-9]\d{9}$)，避免每次调用都 recompile - 业务唯一性校验（如用户名是否存在）不能放这里——DB 查询会阻塞验证流程，应拆到 service 层
为什么 binding:"required,chinese_mobile" 仍报原生错误信息
Gin 默认错误格式是 Key: 'X.Y' Error: Field validation for 'Y' failed on the 'chinese_mobile' tag，根本没进你写的函数，说明验证器压根没挂上，或字段类型不匹配。
立即学习“go语言免费学习笔记（深入）”；
- 检查 struct 字段类型：比如手机号字段声明为
int64，但验证函数里调fl.Field().String()会空字符串，永远 false - 确认 tag 写在正确位置：
json:"phone" binding:"required,chinese_mobile"，不是validate:"..." - 别混用
go-playground/validator/v10的独立 import——Gin v1.9+ 已内置，额外引入会导致版本冲突 panic - 调试技巧：在验证函数第一行加
log.Println("hit chinese_mobile")，看是否被调用
最易忽略的一点：Gin 的 validator 单例只在第一个请求绑定时初始化，此前所有注册操作都必须完成；一旦错过这个窗口，后续注册全失效，且无任何提示——它静默跳过。
