注册自定义正则验证器必须在 gin.default() 之后立即执行，否则因 binding.validator.engine() 未初始化导致静默失效；需类型断言后注册、防重复、区分大小写、避免 panic 和 runtime 编译开销。
注册自定义正则验证器必须在 gin.Default() 之后立即执行
验证器不生效，90% 是因为注册时机错了。Gin 的 binding.Validator.Engine() 在首次调用 c.ShouldBind() 前才初始化，如果在 init() 函数里或路由注册后才注册，RegisterValidation 实际会操作一个 nil 指针或旧实例，完全静默失效。
稳妥做法是：拿到 r := gin.Default() 后，立刻做类型断言和注册，不要嵌套在 handler 或中间件里。
- 检查
binding.Validator.Engine()是否为*validator.Validate类型，否则 panic - 用
v.HasRegisteredNamespace("your_tag")防重复注册（同一 tag 名注册两次会 panic） - tag 名区分大小写：
binding:"mobile_cn"必须对应注册时传的"mobile_cn"，不是"MobileCN"
正则验证函数里别直接 panic，也别 log.Fatal
返回 false 表示校验失败，Gin 会自动收集错误并返回 400；返回 true 表示通过。验证函数里任何 panic、log.Fatal 或 os.Exit 都会导致整个 HTTP server 崩溃 —— Gin 不捕获这些异常。
常见陷阱是：正则编译写成 regexp.MustCompile 放在函数体内，每次调用都重新编译；应提前全局编译好，避免 runtime 开销和潜在 panic。
- 把
regexp.MustCompile(...)提到包级变量或init()中 - 用
fl.Field().String()取值，注意空字段可能返回空字符串，需结合required标签协同使用 - 别在验证函数里调
c.Abort()或c.JSON()—— 这不是 handler，没上下文
带参数的正则验证（如 phone=CN）要靠 fl.Param() 解析
原生 RegisterValidation 不支持参数，但你可以把参数塞进 tag 值里，比如 binding:"required,phone=CN"，然后在验证函数里用 fl.Param() 拿到 "CN"，再分支处理。
这比注册一堆 tag（phone_cn、phone_us、phone_jp）更干净，也避免 tag 名爆炸。
-
fl.Param()返回等号后的字符串，若 tag 是phone（无等号），则返回空字符串 - 正则分支建议用 map 或 switch，避免硬编码多个
if strings.HasPrefix - 地区码校验逻辑建议抽离成独立函数，方便单元测试
错误信息不友好？别指望 binding 自动翻译
Gin 默认错误信息是 Key: 'User.Phone' Error: Field validation for 'Phone' failed on the 'phone_cn' tag，前端根本没法直接展示。它不会自动读取结构体 tag 里的 msg 或 json 字段。
想返回可读错误，必须手动解析 err 并构造响应。关键点是类型断言为 validator.ValidationErrors，再遍历每个 error 获取 Tag()、Field() 和 Value()。
- 别用
err.Error()直接返回，那是调试用的原始字符串 - 用
e.StructNamespace()或e.Field()定位具体字段，配合业务规则映射友好提示 - 如果用了
zh_trans等翻译器，得提前注册 translator 并绑定到 validator 实例，不是 gin 实例
