Golang中基于函数的声明式表单验证器（Validator）设计-Golang-PHP中文网

函数式验证优于struct tag+reflect，因其类型安全、可测试、编译期检查字段名，且支持上下文注入与错误累积；典型做法是用validator切片组合多个纯函数验证器，统一收集并映射错误信息。

golang中基于函数的声明式表单验证器（validator）设计

为什么不用 struct tag + reflect 做验证

因为 runtime 反射开销大、错误定位难、调试不直观，且无法在编译期捕获字段名拼写错误。函数式验证把规则显式写成闭包或纯函数，类型安全、可单元测试、支持提前 return，适合中等复杂度表单（比如登录、注册、配置提交）。

典型陷阱是把验证逻辑塞进一个大函数里，导致难以复用和组合。正确做法是每个校验项返回 error，靠短路逻辑串联：

func validateEmail(email string) error {
    if email == "" {
        return errors.New("email is required")
    }
    if !strings.Contains(email, "@") {
        return errors.New("email format invalid")
    }
    return nil
}

如何组合多个验证函数并统一收集错误

单个函数只管一件事，但用户提交时需要一次性看到所有问题。不能用 || 或 return 早期退出，得累积错误。

定义 Validator 类型为 func() error，方便链式调用
用切片存多个 Validator，遍历执行，append 非 nil error 到 []error
避免用 panic 或 log.Fatal —— 表单验证必须可控失败

示例组合：

validators := []func() error{
    func() error { return validateEmail(req.Email) },
    func() error { return validatePassword(req.Password) },
    func() error { return validateConfirmPassword(req.Password, req.ConfirmPassword) },
}
var errs []error
for _, v := range validators {
    if err := v(); err != nil {
        errs = append(errs, err)
    }
}

怎么让验证器支持上下文（如数据库查重、依赖其他字段）

纯函数没法查 DB 或读 session，所以得把依赖“注入”进去。不要全局变量，也不要在 validator 闭包里捕获太多外部状态。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

把依赖（如 *sql.DB、context.Context）作为参数传入 validator 工厂函数
工厂返回具体 func() error，闭包内只捕获必要变量
注意：DB 查询类验证应设 timeout，避免表单阻塞

例如邮箱唯一性检查：

func makeEmailUniquenessValidator(db *sql.DB, email string) func() error {
    return func() error {
        var exists bool
        err := db.QueryRow("SELECT EXISTS(SELECT 1 FROM users WHERE email = $1)", email).Scan(&exists)
        if err != nil {
            return fmt.Errorf("db query failed: %w", err)
        }
        if exists {
            return errors.New("email already registered")
        }
        return nil
    }
}