validator 包需显式调用 Validate() 校验结构体，嵌套字段加 dive，指针字段慎用 required，时间格式须严格匹配，query/path 参数需手动解析转换并校验，自定义规则必须注册，错误需结构化提取而非直接返回原始 err。
用 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 处理，引发分页越界。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
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 名要和注册名一致，否则完全不触发。
典型错误是定义了 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 到中文的映射需提前配置
参数校验不是加几个 tag 就完事。真正难的是把校验链路串起来：从请求解析、类型转换、结构体绑定、规则触发，到错误归因和响应构造——任一环节松动，非法数据就可能流入业务逻辑。尤其要注意 query/path 参数的类型安全和自定义规则的注册时机，这两处最容易漏检。
