eqfield=password在嵌套结构体中不生效，因validator默认仅在当前struct层级查找字段，不穿透外层；解决需改用eqcsfield、struct-level校验或拉平字段。
为什么 eqfield=Password 在嵌套结构体里总不生效
因为 go-playground/validator 的 eqfield 默认只在**当前 struct 层级**查找字段，不会向上穿透到外层结构体。比如你写 type User struct { Profile Profile } type Profile struct { Password string; Confirm string `validate:"eqfield=Password"` }，Confirm 查不到 Profile.Password —— 它压根不看 User 层。
解决办法只有两个：
- 改用
eqcsfield=User.Profile.Password（注意是eqcsfield，不是eqfield），前提是整个结构体被传入校验时是顶层对象 - 把跨层级逻辑提到上层结构体做 struct-level validation，用
v.RegisterStructValidation注册函数，在函数里手动取值比对 - 避免深层嵌套，把需要关联的字段尽量拉平到同一级结构体中（更易维护、调试、测试）
如何让 c.ShouldBind 同时识别 binding 和 validate 标签
Gin 默认的 ShouldBind 只读 binding 标签，完全忽略 validate；而原生 validator 库默认只读 validate 标签。两者互不兼容，不干预就会“各校各的”，漏掉一半规则。
必须显式桥接：
- 先拿到 Gin 内置 validator 实例：
v, _ := binding.Validator.Engine().(*validator.Validate) - 调用
v.RegisterTagNameFunc，把"binding"作为主标签名（覆盖默认的"validate"） - 或者更稳妥：统一只用
validate标签，然后在初始化 Gin 时替换binding.Validator，让它底层调用你配置好的validator实例 - 别忘了给字段补全
json:或form:标签，否则绑定失败，校验根本没机会触发
自定义校验函数怎么返回带字段名和错误码的 JSON
直接 err.Error() 返回的是英文长字符串，前端无法解析字段名或映射错误码。得自己拆解 validator.ValidationErrors 并重构成结构化数据。
关键步骤：
- 用
errors.As(err, &ve)判断是否为*validator.InvalidValidationError，再从ve.Err提取validator.ValidationErrors - 遍历每个
FieldError，用fe.Field()拿 JSON 字段名（不是fe.StructField()） - 查表映射：
map[string]struct{ Code string; Message string }，例如"eqfield"→{"code": "ERR_CONFIRM_MISMATCH", "msg": "确认密码不匹配"} - 错误信息里的
Tag()是规则名（如"eqfield"），ActualTag()是完整 tag（如"eqfield=Password"），按需提取
为什么加了 required 还是收不到报错，参数却为空
最常见原因：结构体字段缺 json: 标签，或标签名和请求体字段不一致。Gin 先尝试反序列化，字段没被赋值，后续校验自然失效 —— required 不是魔法，它校验的是“已绑定的值”，不是“应该存在的键”。
排查要点：
- POST JSON 请求，结构体字段必须有
json:"xxx"，且xxx和前端发的 key 完全一致（区分大小写） - 如果是
application/x-www-form-urlencoded，得用form:"xxx"，不是json: - GET 查询参数要用
uri:或form:，json:在 query 场景下完全无效 -
c.ShouldBindJSON强制解析 JSON，c.ShouldBind会根据Content-Type自动选解析器，选错就静默失败
嵌套结构体还得多加一层 dive，比如 []User 要写 binding:"dive,required"，不然整个 slice 被当做一个字段跳过校验。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
