应直接测试 validator/v10 而非 Gin 的 ShouldBindJSON，因后者依赖 gin.Context 导致耦合高、定位难；正确做法是手动创建 validator 实例，调用 Validate.Struct() 验证结构体 tag 规则及错误信息。
ShouldBind* 方法本身不提供可测接口，校验逻辑实际由 validator/v10 驱动，所以单元测试必须绕过 Gin 上下文，直接验证结构体 tag 和 validator 实例行为。
为什么不能在 Gin handler 里测参数校验？
因为 ShouldBindJSON 等方法依赖 *gin.Context，而构造完整上下文成本高、耦合重，且无法隔离 validator 本身的逻辑。一旦测试失败，你分不清是路由解析出错、Content-Type 处理异常，还是 tag 写错了——这违背单元测试「只测一个单元」的原则。
真正要测的，是：结构体字段 + binding tag → 是否按预期触发 validator 规则 → 是否返回符合预期的错误信息。
所以正确路径是：用 validator.New() 手动创建实例，调用 Validate.Struct() 直接校验结构体值。
如何写一个可复用的 validator 单元测试？
核心是三步：定义结构体 → 构造非法/合法输入 → 调用 Validate.Struct() 检查错误类型和字段名。
- 别用
c.ShouldBindJSON(&req)做测试入口，它只是胶水，不是被测对象 - 显式 import
"github.com/go-playground/validator/v10"，不要依赖 Gin 内置的隐式 validator 实例（版本或配置可能不一致） - 测试时给结构体字段赋非法值，比如
Email: "invalid"、Age: -5，再断言错误中是否含"Email"或"Age" - 用
assert.ErrorContains(t, err, "Email")比assert.NotNil(t, err)更精准
示例：
func TestSignUpParam_Validation(t *testing.T) {
v := validator.New()
req := SignUpParam{
Name: "",
Email: "not-email",
Age: 150,
}
err := v.Struct(req)
assert.Error(t, err)
assert.ErrorContains(t, err, "Name")
assert.ErrorContains(t, err, "Email")
assert.ErrorContains(t, err, "Age")
}
跨字段校验（如 eqfield）怎么测？
eqfield=Password 这类规则依赖结构体内字段间关系，测试时必须同时设置两个字段，并控制它们相等或不相等。
- 设
Password: "123456"、RePassword: "654321"→ 应报错，且错误信息明确指向RePassword - 设
Password: "123456"、RePassword: "123456"→ 应无错误 - 注意：字段名大小写必须与 struct tag 中
json或binding标签完全一致，否则eqfield查不到目标字段 - 如果用了
json:"re_password"，但bindingtag 没同步写成binding:"eqfield=Password"，校验会静默跳过——这是最常踩的坑
错误提示中文化要不要在单元测试里覆盖？
要，但只测「翻译是否生效」，不测「翻译文案是否优美」。
validator 默认错误是英文字段名（如 Key: 'SignUpParam.Email'），加中文翻译需注册自定义 translator。单元测试只需验证：开启翻译后，错误字符串里是否不再出现 SignUpParam. 前缀，而是出现 "邮箱" 这类词。
- 测试前调用
zhTrans, _ := ut.New(zh, zh).GetTranslator("zh")+v.RegisterTranslation(...) - 断言
assert.NotContains(t, err.Error(), "SignUpParam.Email") - 断言
assert.Contains(t, err.Error(), "邮箱") - 别把翻译逻辑和校验逻辑混在一个 test 函数里——拆成
TestValidator_RawError和TestValidator_ZhTranslation
复杂点在于：validator 的错误结构是嵌套的 ValidationErrors，直接 err.Error() 可能漏掉部分字段。真要严格，得断言 errs := err.(validator.ValidationErrors) 后遍历每个 errs[i].Field() 和 errs[i].Translate(trans)。
