直接调用自定义验证函数做单元测试的最快最稳方式是：提名为具名函数（如isChineseMobile），用validator.New()创建新实例并注册，再通过v.Struct()传入带正确binding标签的结构体触发校验，避免mockFieldLevel或依赖Gin上下文。
怎么直接调用自定义验证函数做单元测试
别绕 Gin 的 c.ShouldBind，直接把验证逻辑抽出来当普通函数测，最快最稳。自定义验证器本质就是 func(fl validator.FieldLevel) bool，它不依赖 HTTP 上下文，只看字段值和参数。
实操建议：
- 把注册时写的匿名函数提成具名函数，比如
isChineseMobile，方便单独 import 和调用 - 用
validator.New()创建一个干净的 validator 实例，再用RegisterValidation注册它 - 构造一个带字段的结构体，用
Struct()触发校验，而不是走 Gin 绑定流程 - 避免在测试里 mock
FieldLevel—— 它是内部接口，难构造；改用真实结构体 + tag 触发更可靠
如何用 test struct + binding tag 验证器行为
让测试尽可能贴近真实使用场景：结构体字段带 binding 标签，然后调 Validate.Struct()，看是否按预期返回 error。
常见错误现象：
- 注册名称和 tag 里写的不一致，比如注册了
"chinese_mobile"，但 struct tag 写成binding:"chineseMobile"（大小写敏感） - 没调
v.RegisterValidation就直接Struct()，结果 validator 完全忽略你的 tag - 正则匹配用了
^1[3-9]\d{9}$，但测试传了"138123456789"（12位），误判为失败
示例片段：
type TestReq struct {
Phone string `json:"phone" binding:"chinese_mobile"`
}
v := validator.New()
_ = v.RegisterValidation("chinese_mobile", isChineseMobile)
err := v.Struct(TestReq{Phone: "13812345678"})
// err 应为 nil
为什么在 Gin handler 里测不到自定义验证触发
不是验证器写错了，而是测试方式错了：你在 handler 里用 c.ShouldBindJSON，但没确保 validator 实例已注册、且注册时机早于第一次绑定调用。
关键点：
-
binding.Validator.Engine()在首次c.ShouldBind时才初始化，init()函数里直接调可能返回nil - 测试用的
gin.CreateTestContext不会自动触发 engine 初始化，得手动补一句binding.Validator访问 - 如果用
httptest.NewRecorder()发请求，必须保证路由初始化前已完成注册，否则验证器根本不会加载
稳妥做法：在测试 setup 阶段显式初始化 validator，并复用同一个实例。
带参数的验证器（如 phone=CN）怎么测
fl.Param() 是唯一能拿到等号后内容的入口，但它的行为容易被忽略：它返回整个 = 后字符串，不做分割。比如 phone=CN,138，fl.Param() 返回的就是 "CN,138"，不是 "CN"。
实操建议：
- 测试时传完整 tag 值，如
binding:"phone=US"，再断言fl.Param() == "US" - 验证函数里别假设
Param()会自动切分，要自己strings.SplitN(fl.Param(), ",", 2)或类似处理 - 空参数也要覆盖，比如
phone=，fl.Param()返回空字符串，别让它 panic
最容易被忽略的地方：验证函数里做了 HTTP 请求或 DB 查询 —— 单元测试会卡住或超时，而且这种 IO 操作本就不该出现在 validator 函数里。
