Go中实现字段值验证需用reflect遍历结构体字段,解析validate标签规则(如required、min、email),安全判断零值,返回含字段名和原因的结构化错误。

在 Go 中实现字段值验证,核心是结合 reflect 包遍历结构体字段,并根据自定义规则(如非空、长度、正则、范围等)判断是否合法。不依赖第三方库也能完成轻量、可控的校验逻辑。
获取结构体反射值并遍历字段
使用 reflect.ValueOf 获取值对象,再通过 .Kind() 确保是结构体类型,用 .NumField() 和 .Field(i) 逐个访问字段值:
- 需先调用
.Elem()处理指针(如传入的是*User) - 用
.Type().Field(i)获取结构体字段的StructField,可读取标签(tag) - 用
.Interface()将反射值转回原始类型,便于比较或调用方法
从 struct tag 提取验证规则
推荐使用标准 validate 标签(如 `validate:"required,min=2,max=20"`),用 strings.Split 解析规则字符串:
-
required:检查值是否为零值(reflect.Zero对应类型的零值) -
min=5:对字符串检查len(),对整数检查是否 ≥5 -
email:对字符串用正则^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$匹配 - 忽略不支持的规则,或记录警告,避免 panic
安全判断零值与类型适配
不能直接用 == nil 或 == "",而应通过反射判断是否为该类型的零值:
立即学习“go语言免费学习笔记(深入)”;
- 调用
v.IsNil()判断指针、map、slice、func、chan、interface 是否为 nil - 对基础类型(string/int/bool),用
v.Interface() == reflect.Zero(v.Type()).Interface() - 对 time.Time、自定义类型,建议统一转成 interface{} 后比较,或定制 IsZero 方法
返回结构化错误信息
验证失败时,不要只返回 error,而是构建带字段名和原因的错误切片:
- 定义
type ValidationError struct { Field, Msg string } - 每验证一个字段,若失败就 append 到
[]ValidationError - 最终用
fmt.Sprintf拼接提示,或提供Error()方法满足error接口
不复杂但容易忽略:始终检查 CanInterface() 再调用 Interface(),避免 “call of reflect.Value.Interface on zero Value” panic;对嵌套结构体,可递归验证,但需限制深度防栈溢出。










