Go标准库无内置表单校验框架，推荐用结构体标签+go-playground/validator统一处理；需注意标签语法、空值处理、嵌套结构体dive、解码与校验合并、urlencoded数据解析及多源数据整合。
Go 语言标准库没有内置的表单多字段校验框架，net/http 只负责接收原始数据，校验必须手动实现或借助第三方库。直接用 if 堆叠判断容易失控，推荐用结构体 + 标签 + 验证库（如 go-playground/validator）统一处理。
用 validator 给结构体字段加校验标签
这是最主流的做法：定义结构体时用 validate 标签声明规则，避免在 handler 里写大量重复逻辑。
type LoginForm struct {
Username string `json:"username" validate:"required,min=3,max=20"`
Password string `json:"password" validate:"required,min=8"`
Email string `json:"email" validate:"required,email"`
}
注意点：
-
validate标签值不支持空格，min=3, max=20会报错，必须写成min=3,max=20 - 如果字段是空字符串但类型为
string，required默认会失败；若允许零值，改用omitempty,required并配合自定义验证函数 - 嵌套结构体需显式加
dive，例如Addresses []Address `validate:"dive"`
在 HTTP handler 中调用校验并返回错误
别在解析 JSON 后才校验，应把解码和校验合并到一步，出错立刻返回。
立即学习“go语言免费学习笔记（深入）”；
常见错误现象：json: cannot unmarshal string into Go struct field X of type int —— 这是类型转换失败，不是 validator 负责的范围，得先确保字段类型匹配。
func loginHandler(w http.ResponseWriter, r *http.Request) {
var form LoginForm
if err := json.NewDecoder(r.Body).Decode(&form); err != nil {
http.Error(w, "invalid JSON", http.StatusBadRequest)
return
}
if err := validator.Validate.Struct(form); err != nil {
var errs []string
for _, e := range err.(validator.ValidationErrors) {
errs = append(errs, e.Field()+" is "+e.Tag())
}
http.Error(w, strings.Join(errs, "; "), http.StatusBadRequest)
return
}
// 校验通过，继续处理
}
关键细节：
-
validator.Validate.Struct()返回的是error，需断言为validator.ValidationErrors才能遍历具体字段错误 - 不要直接返回
err.Error()给前端，它包含内部结构信息，也不符合 API 错误格式习惯 - 如果用了指针字段（如
*string），required对 nil 指针有效，但对空字符串无效，行为需测试确认
处理表单 application/x-www-form-urlencoded 数据
Web 表单 POST 默认是 urlencoded，不是 JSON，不能直接用 json.Decoder。要先调用 r.ParseForm()，再手动映射到结构体，或用 decoder.Decode(&form, r.PostForm)（需引入 github.com/mitchellh/mapstructure）。
更轻量的做法是写个辅助函数：
func parseForm(r *http.Request, dst interface{}) error {
if err := r.ParseForm(); err != nil {
return err
}
if err := mapstructure.Decode(r.PostForm, dst); err != nil {
return err
}
return validator.Validate.Struct(dst)
}
使用时：
var form LoginForm
if err := parseForm(r, &form); err != nil {
http.Error(w, "validation failed", http.StatusBadRequest)
return
}
注意兼容性问题：
-
r.PostForm的 key 是字符串，value 是[]string，mapstructure 会自动取第一个值转成 string，但如果字段允许多选（如复选框数组），需要额外处理 - 日期、数字等类型字段，
urlencoded提交的是字符串，mapstructure 默认不会做类型转换，需加decodeHook或改用strconv手动解析
复杂点在于：同一个字段可能有多种输入来源（JSON body / form / query / header），而 validator 只校验结构体。如果业务需要混合来源校验，就得自己组合数据进结构体，再统一过 validator —— 这步最容易漏掉或顺序错乱。
