golang如何实现API请求参数校验_golang API请求参数校验实现解析-Golang-PHP中文网

validator 包需显式调用 validate() 校验结构体，嵌套字段加 dive，指针字段慎用 required，时间格式须严格匹配，query/path 参数需手动解析转换并校验，自定义规则必须注册，错误需结构化提取而非直接返回原始 err。

golang如何实现api请求参数校验_golang api请求参数校验实现解析

用 `validator` 包做结构体字段校验最直接

Go 没有内置的参数校验机制，但 validator（如 go-playground/validator/v10）是事实标准。它通过 struct tag 声明规则，配合 Validate() 方法触发校验，适合 HTTP handler 中对 JSON body 或表单数据做前置检查。

常见错误是只校验 struct 定义却忘了调用 Validate()，或忽略返回的 error 直接往下走 —— 这会让非法参数静默通过。

必须显式调用 validate.Struct(req)，不能只靠 tag 声明
嵌套结构体需加 valid:"dive"，否则内层字段不参与校验
required 对指针字段（如 *string）默认不生效，得用 required_if 或手动判空
时间字段用 datetime 时，格式必须和传入字符串严格匹配（如 "2006-01-02"），否则报 Key: 'User.Birth' Error:Field validation for 'Birth' failed on the 'datetime' tag

type User struct {
    Name  string `json:"name" validate:"required,min=2,max=20"`
    Email string `json:"email" validate:"required,email"`
    Age   int    `json:"age" validate:"required,gte=0,lte=150"`
}

query 参数和 path 参数要用 `url.ParseQuery` + 手动转换校验

HTTP 请求中的 query（?page=1&size=10）和 path（/users/:id）参数不会自动绑定到 struct，也不能直接用 validator。它们是字符串，需先解析、再类型转换、最后按业务逻辑校验。

容易踩的坑是直接用 strconv.Atoi 转 page 却不检查 error，导致 panic；或把空字符串当 0 处理，引发分页越界。

用 r.URL.Query().Get("page") 取值，别依赖 FormValue（会触发隐式解析，干扰 multipart）
数字类参数必须用 strconv.ParseInt 或 ParseUint，并判断 err != nil
path 参数（如 chi.URLParam(r, "id")）同样要转类型+校验，不能假设前端一定传整数
布尔 query 参数（如 ?active=true）建议用 strconv.ParseBool，而非字符串比对，避免 "1"/"on" 等非标准值漏判

自定义校验函数要注册到 `Validate` 实例，不能只写函数

内置规则覆盖不了所有场景，比如「密码需含大小写字母+数字」或「手机号符合国内号段」。这时要写自定义函数，但光写函数没用 —— 必须注册进 validator 实例，且 tag 名要和注册名一致，否则完全不触发。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

典型错误是定义了 func validatePassword(fl validator.FieldLevel) bool，却忘了调用 v.RegisterValidation("password", validatePassword)，结果校验永远通过。

注册必须在初始化 validator 实例后、首次使用前完成（通常放 init() 或 main 入口）
自定义函数接收 validator.FieldLevel，用 fl.Field().String() 取值，fl.Param() 取 tag 后的参数（如 minlen=8）
不要在自定义函数里 panic，应返回 false 表示失败，validator 会聚合错误
若需跨字段校验（如 password 和 confirm_password），用 StructLevel 注册，而非 FieldLevel

错误提示要提取具体字段和原因，别只丢 `ValidationError`

直接返回 err.Error() 得到的是类似 Key: 'User.Email' Error:Field validation for 'Email' failed on the 'email' tag 的原始信息，前端无法友好展示。必须遍历 err.(validator.ValidationErrors) 提取字段名、失败规则、甚至翻译成中文。

更隐蔽的问题是：同一个字段多个校验失败（如 required 和 email），默认只报第一个，除非开启 SetErrorTag("error") 并遍历全部。

用 errs := err.(validator.ValidationErrors) 类型断言，再 range 遍历
每个 err 有 Field()、Tag()、Value() 方法，可组合出结构化错误
避免拼接字符串返回，用 map 或自定义 error struct（如 map[string][]string{"email": ["邮箱格式不正确", "邮箱不能为空"]}）
如果用了 i18n，注册翻译器后调用 errs.Translate(trans)，但注意英文 key 到中文的映射需提前配置