最稳妥的方式是用 validator 校验结构体字段，而非函数裸参数；因 Go 反射无法获取参数名，错误提示不友好，且基本类型无法加 tag，业务校验还需上下文支持。
直接用 validator 校验结构体字段最稳妥，别在函数签名里试图校验裸参数——Go 的 reflect 拿不到参数名，也无法统一处理错误提示和上下文依赖。
为什么不能对函数参数做通用校验
Go 编译后函数调用不保留形参名，reflect.Value 无法还原 func(name string <code>validate:"required", age int validate:"min=18") 中的 name 和 age 字段标识。强行反射函数签名只能拿到类型和值，错误信息会变成 “arg[0] invalid”，用户完全无法理解。
- 所有通用校验器（包括
go-playground/validator）都要求输入是结构体指针，靠struct tag定义规则 - 函数参数若为基本类型（
string、int）或 map，无法附加validate标签，也没法递归检查嵌套逻辑 - 业务级校验常需上下文（如 DB 连接、租户 ID），而函数参数列表无法承载这些，硬塞进去会让签名失控
正确做法：把参数收进结构体再校验
定义一个明确用途的请求结构体，用 json 和 validate tag 声明规则，绑定后再调用 validate.Struct()。
- 必须先完成反序列化（如
c.ShouldBindJSON(&req)），再校验；否则字段是零值，required对int字段会误报 - 嵌套结构体默认不递归校验，字段要加
dive：例如Address *Address <code>json:"address" validate:"dive" - 指针字段（如
*string）为nil时，required不生效，得改用required_if或显式写nonnil - 避免混用
binding:"required"和validate:"required"，Gin 的binding是轻量解析层，和validator无关联，同时写只会让前者提前返回，后者根本没机会执行
跨字段或动态规则怎么办
标准 validate tag 不支持“结束时间 > 开始时间”这类逻辑，也不能查数据库判断邮箱是否已存在。这时候必须跳出 tag 思维。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 用 struct-level 验证函数：在结构体上实现
Validate() error方法，或调用v.RegisterStructValidation() - 字段级验证通过后才进 struct-level，所以它适合做组合判断，比如先确认
StartTime和EndTime都是非空数字，再比较大小 - 需要 DB 或缓存的校验（如用户名唯一性），不要塞进
Validate()方法里——它不该有副作用；应作为独立子函数，在 handler 中按需调用，比如if err := checkUsernameUniqueness(ctx, req.Username); err != nil { ... } - 错误提示要一致：用
v.SetTagName("json")让错误字段显示为 API 文档里的字段名（如user_name），而不是 Go 变量名（如UserName）
复杂校验如何保持可扩展
把校验逻辑拆成纯函数，每个只做一件事，靠组合而非大函数堆砌。
- 定义类型如
type ValidatorFunc func(interface{}) error，每个函数只负责一块：比如validateEmailFormat、validatePasswordStrength、validateUserExists - handler 里按需组装：
errs := []error{validateEmailFormat(req.Email), validatePasswordStrength(req.Password), validateUserExists(ctx, req.Username)} - 不要在子函数里
panic或打日志，错误统一由上层收集、格式化、返回 HTTP 响应 - 需要上下文（DB、租户 ID）的校验，用 Functional Options 构造 validator 实例，比如
NewValidator(WithDB(db), WithTenantID(tenantID))，而不是把 db 当参数传给每个函数
真正容易被忽略的是：校验不是越早越好，而是要在数据状态稳定之后——比如 ShouldBindJSON 已填充好所有字段、指针非 nil、时间戳已转为 time.Time，这时校验结果才可信。过早校验只是制造假阳性错误。
