如何实现一个通用的Go语言数据校验模块-Golang-PHP中文网

校验规则应通过结构体标签定义以解耦业务逻辑，如validate:"required,min=2,max=20"；解析时避免go表达式、函数注册及逗号分隔，采用键值对；嵌套结构体和slice需递归校验，指针先判空再展开，slice逐项递归。

如何实现一个通用的go语言数据校验模块

校验规则怎么定义才不耦合业务逻辑

校验逻辑如果直接写在 handler 或 service 里，很快就会变成重复的 if len(name) == 0、if age 150 堆砌。真正可复用的校验模块，必须把规则和数据结构绑定，而不是和 HTTP 请求或数据库操作绑定。

推荐用结构体标签（struct tag）声明规则，比如：

type User struct {
    Name string `validate:"required,min=2,max=20"`
    Age  int    `validate:"gte=0,lte=150"`
}

这样校验器只需反射读取 validate 标签，不关心这个结构体是来自 API body 还是配置文件解析结果。

避免用函数注册规则（如 RegisterValidator("age", func(v interface{}) error {...})），会导致校验入口分散、难以追踪
标签值建议用键值对格式（min=2），比纯逗号分隔（required,min=2）更易扩展解析逻辑
不要在标签里写 Go 表达式（如 validate:"age > 0"），执行安全性和性能都不可控

嵌套结构体和 slice 的校验怎么递归处理

真实业务中几乎必然遇到 Address []Address 或 Profile *UserProfile 这类嵌套。如果校验器只扫一层字段，Address[0].City 为空就漏掉了。

关键点在于：遇到指针或 slice 时，先判空再递归；遇到嵌套结构体，直接调用同一套校验逻辑。示例片段：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

func Validate(v interface{}) error {
    rv := reflect.ValueOf(v)
    if !rv.IsValid() {
        return nil
    }
    if rv.Kind() == reflect.Ptr {
        if rv.IsNil() {
            return nil // 允许 nil 指针，由 required 规则控制是否报错
        }
        return Validate(rv.Elem().Interface())
    }
    if rv.Kind() == reflect.Slice {
        for i := 0; i

slice 元素为基本类型（如 []string）时，跳过递归，只校验当前字段的规则（如 max=5）
嵌套结构体里的 required 是独立生效的，不是“父结构体存在就自动满足子字段 required”
注意循环引用：如果 A 包含 B，B 又包含 A，不加检测会栈溢出；简单做法是传入已访问地址 map，或限制最大递归深度（如 5 层）

自定义规则如何注入且不影响默认流程

内置规则（required、email、url）覆盖不了所有场景，比如“密码需含大小写字母和数字”或“订单金额不能超过用户余额”。这时需要插件式扩展。

核心是注册表 + 规则解析解耦：校验器主流程只负责按标签名找对应函数，不硬编码逻辑。

var validators = map[string]func(interface{}) error{
    "required":  validateRequired,
    "email":     validateEmail,
    "password":  validatePasswordComplexity, // 自定义
}

func RegisterValidator(name string, fn func(interface{}) error) {
    validators[name] = fn
}

自定义规则函数签名必须是 func(interface{}) error，返回 nil 表示通过，否则返回具体错误
不要在自定义规则里做 DB 查询（如查余额），那属于业务层职责；校验模块只做无副作用的纯数据判断
注册时机很重要：必须在程序 init 阶段完成，不能在 handler 里动态注册，否则并发下 map 写冲突

错误信息怎么组织才能方便前端消费

返回 "Name is required" 这种字符串对前端很不友好——无法定位字段、无法国际化、无法做 UI 高亮。应该返回结构化错误，至少包含字段路径和错误码。

推荐返回 map[string][]string 或自定义错误类型：

type ValidationError struct {
    Field string `json:"field"`
    Code  string `json:"code"` // 如 "required", "min"
    Msg   string `json:"msg"`
}

// 示例输出
[]ValidationError{
    {Field: "user.name", Code: "required", Msg: "用户名不能为空"},
    {Field: "user.addresses.0.city", Code: "required", Msg: "城市不能为空"},
}