go 的 encoding/json 不解析 struct tag 中的逻辑，第三方验证库仅支持静态字符串形式的 validate tag，不支持闭包或方法调用；自定义验证函数必须签名 func(fl validator.fieldlevel) bool，通过 fl.param() 解析配置参数，并借助 fl.parent() 实现跨字段校验。
为什么 validate tag 默认不支持闭包或方法调用
Go 的 encoding/json 本身不解析或执行 struct tag 中的逻辑，它只做字段映射；第三方验证库（如 go-playground/validator）虽支持 validate tag，但其语法是静态字符串，不支持变量、函数调用或闭包。你写 `validate:"gt=0,my_custom_func"` 可以注册 my_custom_func，但不能写 `validate:"my_custom_func(10, 'admin')"` —— 解析器根本不会尝试去解析括号里的参数。
真正能“传参”的做法，是提前注册一个带上下文的验证函数，并在运行时从 validator.FieldLevel 中提取结构体实例、字段值甚至嵌套字段，间接实现“参数化”逻辑。
- 所有自定义验证函数签名必须是
func(fl validator.FieldLevel) bool - 无法在 tag 字符串里传入 Go 表达式，但可通过 tag 值（如
role=admin）解析为键值对，再在函数内按需使用 - 若需访问同结构体其他字段（比如“密码确认必须等于密码”），要用
fl.Parent().Interface()拿到整个 struct 实例
如何注册并使用带配置参数的自定义验证函数
关键不是让 tag “执行代码”，而是把 tag 当作配置字符串来解析。例如，你想限制某个字段只能是当前用户角色允许的值，可以这样注册：
v.RegisterValidation("in_role_set", func(fl validator.FieldLevel) bool {
// 解析 tag：`validate:"in_role_set=ADMIN,USER"`
param := fl.Param()
allowed := strings.Split(param, ",")
val := fl.Field().String()
for _, a := range allowed {
if strings.TrimSpace(a) == val {
return true
}
}
return false
})
然后在 struct 中使用：
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
type UserReq struct {
Role string `json:"role" validate:"required,in_role_set=ADMIN,USER"`
}
-
fl.Param()返回 tag 中=后面的全部内容（不含引号），需自行strings.Split或正则解析 - 不要在验证函数里 panic，
validator会捕获 panic 并转为校验失败，但不利于调试 - 若参数含逗号或等号（比如枚举值本身是
"A=B"），建议改用 JSON 字符串作为 param，再用json.Unmarshal解析
跨字段校验（比如 password 和 password_confirm）怎么写
单字段验证函数拿不到其他字段值，必须通过 fl.Parent() 获取整个结构体指针，再用反射取值。例如：
v.RegisterValidation("eqfield_ignore_empty", func(fl validator.FieldLevel) bool {
field := fl.Field()
parent := fl.Parent()
otherField, exists := parent.Type().FieldByName(fl.Param())
if !exists {
return false
}
otherValue := parent.FieldByIndex(otherField.Index)
// 忽略空值：如果当前字段为空，直接通过
if !field.IsValid() || field.Interface() == nil || (field.Kind() == reflect.String && field.String() == "") {
return true
}
return reflect.DeepEqual(field.Interface(), otherValue.Interface())
})
使用方式：
type SignupReq struct {
Password string `json:"password" validate:"required,min=8"`
PasswordConfirm string `json:"password_confirm" validate:"required,eqfield_ignore_empty=Password"`
}
-
fl.Parent()返回的是reflect.Value，对应 struct 指针，所以FieldByIndex才能拿到字段值 - 注意类型一致性：比较
string和[]byte会失败，建议统一转成 interface{} 后用reflect.DeepEqual - 不要在验证函数中修改
fl.Parent().Interface()的值，这属于未定义行为，可能破坏原始数据
JSON unmarshal 后才校验？还是先校验再 unmarshal？
必须是先 json.Unmarshal，再调用 Validate.Struct()。因为 validator 是基于反射检查已赋值的 struct 字段，而不是解析 JSON 字符串本身。
这意味着：如果 JSON 字段类型错误（比如传了字符串给 int 字段），json.Unmarshal 会失败并返回 error，根本走不到 validator 这步 —— 所以你要先处理类型错误，再处理业务规则错误。
- 典型流程：接收 []byte →
json.Unmarshal到 struct → 检查 unmarshal error → 调用v.Struct()→ 检查 validator error - 别试图在 unmarshal 过程中做业务校验，那是两个不同层级的事：一个是语法/类型层，一个是语义/规则层
- 如果想统一错误格式（比如都返回
map[string]string），建议封装一个ValidateJSON函数，内部组合这两步
Unmarshal 的 error 就直接进 validator，结果 panic 或静默失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
