go反射通用参数校验核心是通过reflect.Value和reflect.Type动态读取结构体字段的validate标签并按规则校验,支持required/min/email等规则映射、嵌套结构体与切片递归校验,无需第三方库。

用 Go 反射做通用参数校验,核心是通过 reflect.Value 和 reflect.Type 动态读取结构体字段的标签(如 validate:"required,min=3"),再按规则逐个检查值是否合规。不依赖第三方库也能实现轻量、可扩展的校验逻辑。
提取结构体字段与校验标签
先用 reflect.typeof 获取类型信息,遍历其字段;用 field.Tag.Get("validate") 提取自定义校验规则字符串。注意要传入指针(&v)才能对非导出字段以外的结构体做反射操作,且需判断是否为指针再解引用。
- 若传入的是值类型(如
MyStruct{}),需用reflect.ValueOf(&v).Elem()转为可寻址的 Value - 跳过匿名字段和不可导出字段(
!field.IsExported())避免 panic - 空标签(
"")或无validate标签的字段默认跳过校验
解析 validate 标签并映射校验函数
将类似 "required,max=10,regexp=^[a-z]+$" 的字符串拆成键值对(max=10)或布尔项(required)。建议用 Strings.Split 分割逗号,再用 strings.Contains 或 strings.SplitN 拆键值。每种规则对应一个校验函数,例如:
把规则名和函数存在 map[string]func(reflect.Value) Error 中,便于动态调用。
立即学习“go语言免费学习笔记(深入)”;
支持嵌套结构体与切片元素校验
遇到字段类型是结构体或切片时,递归调用校验函数即可。对切片需遍历每个元素:for i := 0; i ,再对 <code>value.Index(i) 做校验。嵌套结构体则直接传入 value.Interface()(确保该值可寻址且非 nil)。
- 切片元素为结构体时,每个元素单独走一遍完整校验流程
- 嵌套前加空值判断(
if !value.IsValid() || value.IsNil()),避免 panic - 错误信息建议带上路径(如
"User.Profile.Name: required"),方便定位
返回结构化错误并支持快速失败/全量收集
校验函数可返回 error 或自定义的 ValidationErrors []ValidationError。前者适合快速失败(遇到第一个错就返回),后者适合前端一次性展示所有问题。推荐后者,结构体可定义为:
type ValidationError struct { Field string Tag string Value interface{} Message string }
- 每次校验失败时 append 一条记录,最后统一格式化输出
- Message 可内置翻译(如
"%s 不能为空"→fmt.Sprintf(msg, field.Name)) - 对外暴露
Validate(v interface{}) ValidationErrors方法,简洁易用
基本上就这些。反射校验不复杂但容易忽略边界情况——比如指针解引用、零值判断、切片为空、嵌套 nil。写好基础框架后,新增规则只需往 map 里加函数,维护成本低,也利于统一约束业务模型。