最常见 panic 是 validator 对 nil 指针字段调用 reflect.value.interface()；根本原因是 *string/*int 等字段为 nil 且未加 required 或 omitempty 校验规则，json 中 {"field": null} 触发该问题。
validator 包 panic: reflect: call of reflect.Value.Interface on zero Value 是什么情况
这是最常遇到的 panic，根本原因是传给 validator.Validate 的结构体字段值为 nil 指针（比如 *string、*int），而字段没加 omitempty 且没设置默认非空校验规则。
实际场景多见于 API 接收 JSON 请求体时，前端传了 {"name": null}，后端用 *string 接收，但校验器试图对 nil 指针调用 Interface() —— 反射失败。
- 解决办法：所有指针字段必须显式加
validate:"required"` 或 `validate:"omitempty,required"，不能只依赖类型声明 - 更稳妥的做法是统一用非指针类型（如
string）接收，让零值（空字符串）走业务逻辑判断，而非靠 validator 强制非空 - 如果必须用指针（例如区分“未提供”和“提供了空值”），则需在调用
Validate前手动检查是否为 nil，或改用validator.WithRequired(true)配置（部分 fork 版本支持）
为什么 struct tag 里写 validate:"email" 却不报错，但邮箱格式明显不对
validate:"email" 默认只做基础格式检查（含 @ 和域名部分），不发 DNS 查询、不验证 MX 记录，也不校验长度或 Unicode 字符。它通过正则匹配，宽松得近乎摆设。
典型误用场景：用户输入 "test@.com" 或 "a@b.c" 居然能过；又或者前端传了带中文邮箱（如 "张三@gmail.com"）—— Go 的 net/mail 解析器本身就不支持，但 validator 不拦。
立即学习“go语言免费学习笔记（深入）”；
- 真正需要强校验时，应额外调用
mail.ParseAddress或用go-email-validator这类专用库 -
validate:"email,hostname"可以加一层主机名校验（要求域名部分能被解析），但依然不保证真实可达 - 注意：若字段是
*string且为 nil，email校验会被跳过 —— 这不是 bug，是 validator 的设计逻辑：nil = 未设置，除非你写了required
自定义 validator 函数注册后不生效，返回 error 是 nil
注册自定义函数后调用 Validate.Struct 没报错，但该字段始终没触发校验逻辑，大概率是函数签名或注册方式错了。
常见错误包括：函数返回值不是 bool + error，或参数不是 interface{}，或没用 validator.RegisterValidation 正确绑定名称。
- 正确签名必须是：
func(fl validator.FieldLevel) bool（注意不是func(interface{}) bool） - 注册时名称要和 tag 里的一致：
v.RegisterValidation("ltefield", lteFieldValidator)→ tag 写validate:"ltefield=OtherField" - 别忘了在初始化时只注册一次，重复注册会 panic；建议放在
init()或 main 入口早期 - 调试技巧：在自定义函数开头加
fmt.Printf("called with %v\n", fl.Field().Interface())，确认是否真被调用
validator 在 Gin 中绑定请求体时，嵌套 struct 校验失效
Gin 的 c.ShouldBind 默认用 mapstructure 解码，它对嵌套结构体（如 type User struct { Profile Profile } ）不会自动递归调用 validator，只会校验顶层字段。
结果就是 Profile.Name 上的 required 完全不触发，即使你写了 validate:"required"。
- 必须显式启用嵌套校验：在 struct tag 里给嵌套字段加
validate:"required,dive"（dive是关键） - 如果嵌套字段本身是指针（
*Profile），还得补上omitempty，否则 nil 时 dive 会 panic - 切片嵌套同理：
[]Address需写validate:"dive"，但每个元素的校验规则要写在Address结构体内部，不能写在切片字段 tag 里 - 注意性能：dive 会深度反射遍历，字段层级深、数量多时有明显开销，上线前建议压测
嵌套校验容易漏掉 dive，而且 panic 信息不提示具体哪层出问题，查起来费时间。
