Go中自定义字段验证需解析validate tag并反射校验:先定义tag格式(如required,min=3),再用strings/strconv解析为map,最后通过reflect遍历字段,按类型执行零值、长度、数值、邮箱等规则校验,失败返回含字段名的错误。

在 Go 中,字段标签(struct tag)是实现运行时元数据注入的常用方式,比如 json:"name"、gorm:"column:name"。要实现自定义的字段验证(如 validate:"required,min=3,max=20"),关键在于:解析结构体字段的 tag 字符串,并按约定规则提取约束条件,再对字段值执行对应校验逻辑。
一、定义验证规则 tag 格式
统一使用 validate key,值为逗号分隔的键值对或布尔标记,例如:
type User struct {
Name string `validate:"required,min=3,max=10"`
Email string `validate:"required,email"`
Age int `validate:"required,gt=0,lt=150"`
}
其中:
– required 表示非空(对字符串/切片/映射/指针等判断是否零值)
– min=3 表示最小长度(字符串)或最小数值(数字)
– email 表示需匹配邮箱正则
– gt=0 表示大于 0(支持 gt、gte、lt、lte)
二、解析 validate tag 字符串
用标准库 strings 和 strconv 拆解 tag 值,转为 map 或结构体便于后续调用:
- 按
,分割每个 rule(如"required"、"min=3") - 对含
=的 rule,拆成 key 和 value(如min → "3") - 对无
=的 rule,value 设为空字符串(如required → "") - 建议封装为函数
parseValidateTag(tag string) map[string]string
三、反射遍历字段并执行验证
借助 reflect 包获取结构体字段及其 tag 和值:
立即学习“go语言免费学习笔记(深入)”;
- 对每个字段,先检查是否有
validatetag;没有则跳过 - 调用解析函数得到 rule map
- 根据字段类型(string/int/float/bool 等)和 rule 类型分别处理:
-
required:用reflect.Value.IsZero()判断是否为零值 -
min/max:对字符串取.Len(),对数字转为int64后比较 -
email:用regexp.MustCompile(`^.+@.+\..+$`).MatchString() -
gt/lt等:统一转为 float64 比较,兼容 int/uint/float 类型
-
- 任一 rule 失败即返回错误,可携带字段名与失败规则(如
"Name: min=3 failed, got length 2")
四、封装成易用的 Validate 函数
对外暴露一个通用入口,隐藏反射细节:
func Validate(v interface{}) error {
val := reflect.ValueOf(v)
if val.Kind() == reflect.Ptr {
val = val.Elem()
}
if val.Kind() != reflect.Struct {
return errors.New("Validate only supports struct or *struct")
}
return validateStruct(val)
}
调用示例:
u := User{Name: "A", Email: "invalid", Age: -5}
if err := Validate(&u); err != nil {
log.Println(err) // Name: min=3 failed; Email: email invalid; Age: gt=0 failed
}
不复杂但容易忽略:注意指针解引用、零值判断边界(如空字符串、nil 切片)、数字类型转换溢出保护(可用 golang.org/x/exp/constraints 辅助泛型约束)。










