eqfield=password在嵌套结构体中不生效，因其仅在当前struct层级查找字段名，不支持点号路径（如profile.password）；正确方式是使用structlevel验证器，通过反射手动比对跨字段值，并将错误包装为*validator.fielderror。
为什么 eqfield=Password 在嵌套结构体里总不生效
因为 eqfield 默认只在当前 struct 层级查找字段，不会向上穿透嵌套层级。比如你写 binding:"eqfield=Profile.Password"，validator 会去当前 struct（如 LoginReq）里找叫 Profile.Password 的字段，而不是去 LoginReq.Profile 的字段里找 Password。
- 实际字段路径是
LoginReq.Profile.Password，但eqfield不支持点号路径解析 - 哪怕你把 tag 写成
eqfield=Profile.Password，validator 也只会按字符串字面匹配字段名，不是反射路径访问 - 常见错误现象：校验始终通过，或 panic 报 “field Profile.Password not found”
用结构体级别验证器做跨字段依赖校验
真正能处理 ConfirmPassword == Password 或 EndTime > StartTime 这类逻辑的，是结构体级别验证器（StructLevel），不是字段级 tag。
- 必须实现
binding.StructValidator接口，重写ValidateStruct方法 - 在方法内用
reflect取出两个字段值，手动比对（比如EndTime.After(StartTime)） - 错误要包装成
*validator.FieldError，否则 Gin 不识别——可用validator.NewFieldError(...)构造 - 注册方式不是
RegisterValidation，而是直接赋值给engine.Validator字段 - 必须在
gin.Default()之后、任何路由注册之前完成替换
注册自定义 StructLevel 验证器的正确时机和写法
别在 init() 里注册，也别在 handler 里注册——binding.Validator.Engine() 在首次 ShouldBind 后才初始化，init() 时调用大概率返回 nil。
- 在
main()开头、r := gin.Default()之后立即写： if v, ok := binding.Validator.Engine().(*validator.Validate); ok { v.RegisterStructValidation(yourStructLevelFunc, YourStructType) }-
YourStructType必须是具体类型（如reflect.TypeOf(&LoginReq{}).Elem()），不能是接口 - 如果注册多次同名 struct，会 panic；建议加
!v.IsStructRegistered(YourStructType)防御
字段名 vs 结构体字段名：错误提示该用哪个
前端消费的是 JSON key，不是 Go 字段名。所以 FieldError.Field() 返回的是 struct tag 里的 json: 值，而 StructField() 返回的是 Go 字段名（如 ConfirmPassword）。
- 构造错误信息时，用
fe.Field()（例如"confirm_password"），不是fe.StructField()（"ConfirmPassword"） - 如果你的 struct tag 是
json:"confirm_password"，那前端看到的字段就是confirm_password - 中文提示映射表 key 应为
"confirm_password.eqfield"，不是"ConfirmPassword.eqfield"
