用 func(string) error 定义校验函数最轻量：统一字符串输入、无反射开销、易测试复用；组合用切片遍历，错误带字段上下文，结构体验证前转 string，避免空指针和嵌套判断。
用 func(string) error 定义校验函数最轻量
Go 没有内置表单验证框架，硬套结构体标签（如 validate:"required,email"）容易让规则散落在各处、难以测试和复用。直接写校验函数反而更可控——每个规则就是一个独立的 func(string) error，输入字符串，返回错误或 nil。
常见错误是把校验逻辑塞进 struct 方法里，导致无法单独测试、也无法组合。比如邮箱校验不该绑定在 User 结构体上，而应是：
func ValidateEmail(s string) error {
if s == "" {
return errors.New("email required")
}
if !strings.Contains(s, "@") {
return errors.New("invalid email format")
}
return nil
}
- 所有参数都是
string类型，统一入口，前端传来的字段值可直接喂进去 - 不依赖任何第三方 tag 解析器，无反射开销，编译期可见
- 函数名即语义，
ValidatePhone、ValidatePasswordStrength一眼可知用途
组合多个校验函数用 func(string) error 切片
单个字段常需多重检查（非空 + 格式 + 长度），硬写 if 嵌套难维护。把校验函数存成切片，遍历执行，出错就停，是最自然的组合方式。
典型场景：注册接口对 password 字段做三重校验
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
var PasswordValidators = []func(string) error{
ValidateRequired,
ValidateMinLength(8),
ValidateHasUppercase,
}
func ValidatePassword(s string) error {
for _, v := range PasswordValidators {
if err := v(s); err != nil {
return err
}
}
return nil
}
-
ValidateMinLength(8)是闭包函数，返回func(string) error，避免重复写数字字面量 - 顺序很重要：先
ValidateRequired，再查长度，否则空字符串会触发Index out of range - 不要用
errors.Join收集所有错误——用户只需知道第一个问题在哪，后端日志才需要完整链路
结构体字段验证时别直接传指针，先转 string
HTTP 表单解析后通常是 url.Values 或 JSON 映射的 struct，但校验函数只认 string。常见坑是试图让校验函数接收 *string 或 interface{}，结果要写一堆类型断言和空指针判断。
正确做法：在调用前做一层薄转换
type SignupForm struct {
Email string `json:"email"`
Password string `json:"password"`
}
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)
}
return nil
}
- struct 字段本身是
string，不用解引用、不用判空——Go 的零值语义天然支持 - 如果字段是
*string（比如 Swagger 生成代码），先做if f.Email == nil { return errors.New("email required") }，再传*f.Email，别让校验函数承担空指针逻辑 - JSON unmarshal 后字段为空字符串而非 nil，所以
ValidateRequired必须检查s == ""，不能只看s == nil
自定义错误要带字段上下文，别只返回 "invalid"
API 返回错误时，前端需要知道是哪个字段出问题。纯字符串错误（如 "invalid email"）无法结构化提取字段名，后续加 i18n 或客户端提示也麻烦。
推荐用自定义错误类型封装字段名：
type FieldError struct {
Field string
Err error
}
func (e *FieldError) Error() string {
return fmt.Sprintf("%s: %v", e.Field, e.Err)
}
// 使用
return &FieldError{Field: "email", Err: errors.New("missing @")}
- HTTP handler 中可统一拦截
*FieldError，转成 JSON：{"field": "email", "message": "missing @"} - 别用
fmt.Errorf("email: %w")——虽然能拼接，但无法用类型断言提取字段名，调试和自动化处理都受限 - 如果项目已用
github.com/go-playground/validator，它的ValidationErrors本质也是类似思路，只是抽象层更厚；自己实现时不必追求等价，够用且易 debug 就行
真正难的不是写几个校验函数，而是让所有人遵守“字段转字符串再进校验”的约定——一旦有人绕过、直接在 handler 里手写 if 判断，整套复用机制就断了。
