RegisterValidation 不适合跨字段校验，因其仅接收单字段值和 tag 参数，无法访问其他字段、结构体实例或上下文；跨字段逻辑须用 StructLevelValidation，而 DB 或上下文依赖校验必须移至 handler/service 层。
直接在 Gin 里注册一个 func(fl validator.FieldLevel) bool 函数，解决不了跨字段、依赖 DB 或需要上下文的校验——比如“用户名不能与已注册邮箱相同”或“优惠券不可与满减叠加”。这类逻辑必须下沉到结构体级别验证器（StructLevelValidation）或业务层手动校验，否则会漏判、难调试、无法复用。
为什么 RegisterValidation 不适合跨字段校验
RegisterValidation 只能拿到单个字段值和它的 tag 参数（通过 fl.Param()），完全看不到其他字段。像 start_time 和 end_time 的大小比较，或 password 是否包含 username，它连 username 字段名都读不到。
- 字段级验证函数签名强制为
func(fl validator.FieldLevel) bool，没有结构体实例传入 - 即使你反射取了整个 struct，
fl.Parent()返回的是reflect.Value，但 Gin 的ShouldBind流程中不保证该 parent 已完成赋值（尤其嵌套结构体） - 错误信息里字段名是
Parent.Field形式（如User.Password），前端解析困难，且无法统一映射中文提示
用 StructLevelValidation 做字段间逻辑校验
真正可靠的跨字段校验，得靠 validator.StructLevelFunc：它接收整个结构体的 validator.StructLevel 实例，可安全取任意字段值，并用 sl.ReportError() 手动上报错误。
- 注册方式不是
RegisterValidation，而是v.RegisterStructValidation(YourFunc, YourStructType) - 函数内用
sl.Current().Interface().(*YourStruct)转成具体类型，再取字段 - 上报错误时，第二个参数填 struct 字段名（如
"Password"），第三个填 JSON tag（如"password"），这样fe.Field()才返回"password"，匹配前端 key - 别忘了在
main()中调用注册，且必须在任何路由初始化之前
示例：
func UserStructLevelValidation(sl validator.StructLevel) {
user := sl.Current().Interface().(*User)
if user.Password != "" && strings.Contains(user.Password, user.Username) {
sl.ReportError(user.Password, "Password", "password", "password_username_conflict", "")
}
if !user.StartTime.Before(user.EndTime) {
sl.ReportError(user.EndTime, "EndTime", "end_time", "end_time_before_start", "")
}
}
// 注册
if v, ok := binding.Validator.Engine().(*validator.Validate); ok {
v.RegisterStructValidation(UserStructLevelValidation, User{})
}
带 DB 或上下文的校验必须移出 validator
validator 是纯数据层校验器，不持有 request context、DB 连接或中间件状态。像“手机号是否已注册”“优惠券是否过期”这类检查，硬塞进 StructLevelValidation 会导致：
- validator 实例被污染（需注入 *gorm.DB 等依赖，破坏无状态设计）
- 单元测试无法 mock DB，测试成本陡增
- 错误堆栈混杂 DB 超时、连接失败等非业务错误，前端无法区分
正确做法是：先用 c.ShouldBind 过基础规则，再在 handler 里查 DB 或调用 service 层校验，失败则用统一错误码返回，例如：
func Register(c *gin.Context) {
var req RegisterReq
if err := c.ShouldBind(&req); err != nil {
c.JSON(http.StatusBadRequest, ErrorResponse(err))
return
}
if exists, _ := userService.ExistsByMobile(req.Mobile); exists {
c.JSON(http.StatusBadRequest, gin.H{"code": 1002, "msg": "手机号已被注册"})
return
}
// 继续业务逻辑
}
真正难的不是写验证函数，而是分清边界：validator 只管“格式对不对、字段间逻辑通不通”，所有依赖外部系统或业务状态的判断，一律交给 handler 或 service 层做——否则调试时你会在 validator 里打 log 却收不到输出，因为 Gin 根本不捕获它的 panic，也不透传 context。
