如何在Golang中实现表单验证_使用自定义函数检查输入合法性_技术教程

Go中表单验证应通过自定义函数实现，每个函数专注单一职责、返回带字段上下文的error，结构体Validate()方法组合调用，支持短路或批量错误收集，必要时可用标签+反射轻量扩展。

在 Go 中实现表单验证，核心是**不依赖框架也能写出清晰、可复用、易测试的校验逻辑**。使用自定义函数检查输入合法性，关键在于把验证规则封装成独立函数，再组合调用——既灵活又符合 Go 的简洁哲学。

定义验证函数：以类型和语义为中心

避免写“万能 validate()”函数。每个验证函数只做一件事，接收明确参数，返回 error 或布尔值（推荐前者，便于链式错误收集）。

邮箱格式：func ValidateEmail(email string) error —— 用 net/mail.ParseAddress 或正则（如 ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$），注意别过度校验（比如 MX 检查应放在业务层）
手机号：func ValidatePhone(cn bool, phone string) error —— 区分国内/国际，国内可用 ^1[3-9]\d{9}$，但建议结合号段库或运营商接口做增强
密码强度：func ValidatePassword(pwd string) error —— 检查长度（≥8）、大小写字母、数字、特殊字符（至少三类），不用正则硬拼，用 strings.Map 或遍历统计更清晰

组合验证：用结构体 + 方法统一入口

将表单数据建模为结构体，为它实现 Validate() 方法，内部调用各字段的自定义验证函数：

type SignupForm struct {
    Email    string `json:"email"`
    Password string `json:"password"`
    Phone    string `json:"phone"`
}

func (f *SignupForm) Validate() error {
    if err := ValidateEmail(f.Email); err != nil {
        return fmt.Errorf("email: %w", err)
    }
    if err := ValidatePassword(f.Password); err != nil {
        return fmt.Errorf("password: %w", err)
    }
    if err := ValidatePhone(true, f.Phone); err != nil {
        return fmt.Errorf("phone: %w", err)
    }
    return nil
}

这样调用只需 if err := form.Validate(); err != nil { ... }，错误信息自带字段上下文，方便前端定位问题。

支持批量错误收集（非短路模式）

默认验证一出错就返回，不利于用户一次性修正多个问题。可改用切片收集所有错误：

func (f *SignupForm) ValidateAll() []error {
    var errs []error
    if err := ValidateEmail(f.Email); err != nil {
        errs = append(errs, fmt.Errorf("email: %w", err))
    }
    if err := ValidatePassword(f.Password); err != nil {
        errs = append(errs, fmt.Errorf("password: %w", err))
    }
    if err := ValidatePhone(true, f.Phone); err != nil {
        errs = append(errs, fmt.Errorf("phone: %w", err))
    }
    return errs
}

调用后判断 if len(errs) > 0，再合并返回（如 strings.Join(..., "; ")），适合 API 返回多字段错误详情。

进阶：用标签驱动 + 反射（轻量级）

如果字段多、规则重复，可仿照 validator 库思路，用结构体标签声明规则，再写通用校验器：

type LoginForm struct {
    Email    string `validate:"required,email"`
    Password string `validate:"required,min=6"`
}

// 简单解析标签，调用对应函数（ValidateRequired, ValidateEmail...）
func ValidateStruct(v interface{}) []error { ... }