Go中基于反射的数据校验通过reflect遍历结构体字段、解析validate标签、动态执行规则、聚合错误实现轻量可扩展校验;需注意导出字段、类型判断、嵌套递归防循环、自定义验证器及钩子扩展。

在 Go 中实现基于反射的数据校验,核心是利用 reflect 包遍历结构体字段,读取其标签(如 validate),并根据规则动态执行校验逻辑。它不依赖第三方框架也能快速搭建轻量、可扩展的校验层。
获取结构体字段与标签信息
通过 reflect.TypeOf 和 reflect.ValueOf 分别获取类型和值,再用 NumField 遍历字段。每个字段的 Tag.Get("validate") 可提取自定义校验规则,例如 `validate:"required,min=3,max=20"`。
- 注意:必须传入结构体指针或导出字段(首字母大写),否则反射无法访问
- 用
field.Type.Kind()判断基础类型(string,int,bool等),避免对非标类型误判 - 支持嵌套结构体:递归调用校验函数,但需防止无限循环(比如循环引用)
解析 validate 标签并映射校验规则
标签值通常为键值对形式,可用简单字符串分割或正则提取。例如将 "required,email,lt=100" 拆成操作符列表,再逐个匹配预定义的校验器。
-
required→ 检查零值(value.IsZero(),注意 time.Time、指针等需特殊处理) -
min=5→ 转换为 int 后比较(需先确认字段可转为整数类型) -
email→ 对 string 字段调用mail.ParseAddress或正则校验 - 规则可注册到 map 中:
validators["email"] = func(v interface{}) error { ... }
统一错误收集与返回格式
不要在校验失败时立即 panic 或返回单个 error,而是累积所有字段错误,最后以结构化方式返回(如 map[string][]string)。
立即学习“go语言免费学习笔记(深入)”;
- key 为字段名(
field.Name),value 是该字段的多个错误描述切片 - 错误信息尽量带上下文:例如
"age: must be greater than 0",而非泛泛的"validation failed" - 可封装为
ValidationError类型,实现error接口,便于上层统一处理
支持自定义校验器与钩子扩展
预留接口让使用者注入业务逻辑,比如 “用户名不能与已有用户重复” 这类需查库的规则。
- 定义函数类型:
type CustomValidator func(interface{}) error - 在结构体标签中使用
custom=xxx,运行时从注册表查找对应函数 - 提供前置/后置钩子(如
BeforeValidate),用于数据预处理(trim、normalize)
基本上就这些。不需要复杂抽象,把反射遍历、标签解析、规则执行、错误聚合四步串起来,就能支撑大部分 API 请求参数校验场景。关键在字段类型安全判断和错误提示友好性,而不是堆功能。










