当前位置：首页 > 文章列表 > Golang > Go教程 > Go 结构体输入校验怎么把规范化和错误收集放在一次处理里

Go 结构体输入校验怎么把规范化和错误收集放在一次处理里

来源：17golang原创 2026-10-05 14:58:12 0浏览收藏

Go 接收外部 JSON 时，比较稳妥的边界做法是：先把空白、大小写等可确定的格式差异规范化，再一次检查所有字段并返回完整错误集合。这样业务层拿到的是可预测的数据，客户端也不用“修一个错、再提交一次”地来回试。

这篇文章受到 Golang News 最近分享的 Checker 项目启发，但示例只使用 Go 标准库重新组织思路，不复制项目的标题、实现或代码。项目官方地址：https://github.com/cinar/checker

先把输入边界固定下来

规范化不是把所有值都“改成看起来正确”。适合自动处理的是没有业务歧义的格式动作，例如去掉用户名两端空白、把邮箱域名统一为小写；金额、权限和状态这类字段不应该偷偷替用户改变。解析 JSON 后，先得到一个可修改的请求对象，再把它送入验证函数，边界会比较清楚。

请求输入、规范化、字段校验和业务结构体的关系说明图 — 图1：输入边界说明图，先规范化再进入字段校验。

package main

import (
    "errors"
    "fmt"
    "net/mail"
    "strings"
)

// SignupInput 是接口边界对象；字段值仍可能来自不可信请求。
type SignupInput struct {
    Username string `json:"username"`
    Email    string `json:"email"`
    Quantity int    `json:"quantity"`
}

// FieldError 保留字段名和用户可读原因，便于接口统一返回。
type FieldError struct {
    Field string
    Msg   string
}

// normalize 只做没有业务歧义的清理，不替用户猜测业务值。
func (in *SignupInput) normalize() {
    in.Username = strings.TrimSpace(in.Username)
    in.Email = strings.ToLower(strings.TrimSpace(in.Email))
}

// validate 继续检查全部字段，避免首个错误遮住后续错误。
func (in SignupInput) validate() []FieldError {
    var errs []FieldError
    if in.Username == "" {
        errs = append(errs, FieldError{"username", "不能为空"})
    }
    if _, err := mail.ParseAddress(in.Email); err != nil {
        errs = append(errs, FieldError{"email", "格式不正确"})
    }
    if in.Quantity  20 {
        errs = append(errs, FieldError{"quantity", "必须在 1 到 20 之间"})
    }
    return errs
}

func check(in *SignupInput) error {
    // 先修改边界对象，再把全部字段错误一次性交给调用方。
    in.normalize()
    fieldErrs := in.validate()
    if len(fieldErrs) == 0 {
        return nil
    }
    return errors.New(fmt.Sprintf("输入包含 %d 个字段错误", len(fieldErrs)))
}

上例故意让 check 只返回一个总错误，生产接口通常还会把 []FieldError 序列化为字段到消息的映射。关键点不在错误字符串，而在“规范化只做确定动作、校验不提前退出”这两个约束。

一次处理收集全部字段错误

如果只返回第一个错误，调用者很难一次修完表单。验证函数应当为每个字段追加独立结果，最后再由 HTTP 层转换为稳定的响应结构。字段顺序可以固定，方便测试和前端展示；不要把原始输入值直接拼进错误消息，以免把敏感信息写入日志。

多个字段校验结果汇入统一错误集合的说明图 — 图2：字段错误汇聚说明图，客户端一次看到完整修正清单。

type ValidationError struct {
    Fields []FieldError
}

// Error 只描述错误数量，详细字段信息由 Fields 单独编码。
func (e ValidationError) Error() string {
    return fmt.Sprintf("有 %d 个字段需要修正", len(e.Fields))
}

func validateInput(in *SignupInput) error {
    // 规范化必须发生在校验之前，避免同一值出现两套判断结果。
    in.normalize()
    fields := in.validate()
    if len(fields) > 0 {
        return ValidationError{Fields: fields}
    }
    return nil
}

在处理器里可以用类型断言取回字段列表，再编码成 {"errors":[...]}。如果项目需要兼容被包装过的错误，可用 errors.As；使用 Go 1.26 及以上时，也可以用 errors.AsType 得到具体错误类型，官方文档说明它会沿着错误树查找匹配类型。