多级嵌套结构体的 Validate() 必须递归调用子结构体的 Validate()，跨字段联合校验应提取为独立函数，StructLevel 校验需手动 ReportError，条件性嵌套校验前须判空。
多级嵌套结构体的 Validate() 方法必须递归调用
当表单包含嵌套结构（如 User 内含 Address，Address 又含 Coordinates）时，单层 Validate() 无法穿透校验。若只在校验顶层结构体时忽略子结构，会导致 Address.PostalCode 格式错误却无报错。
正确做法是让每个嵌套结构体都实现 Validate() error，并在父结构体的 Validate() 中显式调用：
-
Address的Validate()负责检查Street非空、PostalCode符合正则 -
User的Validate()先校验自身字段，再调用u.Address.Validate() - 任一子调用返回非
nilerror，立即返回，不继续后续逻辑
别依赖 validator 库的 tag 自动递归——go-playground/validator 默认不递归验证嵌套结构体，除非显式启用 StructLevel 并注册结构级校验函数。
跨层级字段联合校验必须提取为独立参数传入
比如“订单总金额 = 所有商品行金额之和 × 数量”，这个逻辑横跨 Order.Total 和 Order.Items[i].Price、Order.Items[i].Quantity。不能靠 gtfield 或 eqfield 解决，因为涉及切片遍历与聚合计算。
立即学习“go语言免费学习笔记（深入）”；
推荐做法是把需要联动的字段作为整体传给一个校验函数：
- 定义
func ValidateOrderConsistency(total float64, items []OrderItem) error - 在
Order.Validate()中先计算sum := calcTotal(items)，再调用该函数 - 避免在
ValidateOrderConsistency内部重新解析或转换类型，保持纯函数特性，方便单元测试
常见坑：直接在 Validate() 里写循环求和并对比，导致逻辑耦合、难以复用、无法单独测校验规则本身。
validator 库的自定义 StructLevel 函数容易漏掉 error 包装
使用 RegisterStructValidation 注册结构级校验时，回调函数签名是 func(sl validator.StructLevel)，它不返回 error，而是要求你手动调用 sl.ReportError(...) 报告失败。
若忘记调用或参数顺序错（比如把字段名传成值），校验会静默通过，没有任何提示：
- 必须用
sl.CurrentStruct.Interface()获取当前结构体实例，再类型断言 - 报错时第一个参数是结构体字段名（如
"Items"），第二个是实际要标红的字段名（如"price"），第三个是 tag 名（如"validate"） - 错误信息不会自动带字段路径，如需
items[0].price这种提示，得自己拼接sl.Top().Name()和索引
比 StructLevel 更可控的方式是放弃 tag，直接在 Validate() 里做判断并返回带上下文的 fmt.Errorf("items[%d].price must be > 0", i)。
条件性嵌套校验（如 only if type == "premium"）需提前判空
当某个嵌套结构体指针字段仅在特定条件下有效（如 Order.PremiumDetails *PremiumInfo 仅当 Order.Type == "premium" 时需校验），容易在未初始化时 panic。
关键点在于：校验前必须检查指针是否为 nil，而不是直接调用 Validate()：
- 错误写法：
if o.Type == "premium" { return o.PremiumDetails.Validate() }—— 若PremiumDetails为nil，会 panic - 正确写法：
if o.Type == "premium" && o.PremiumDetails != nil { return o.PremiumDetails.Validate() } - 更健壮写法：在
PremiumInfo.Validate()开头加if p == nil { return nil }，允许空指针安全通过
这个细节在文档里常被忽略，但生产环境里因前端漏传字段或 JSON 解析失败导致结构体字段为 nil，是最常见的 panic 来源之一。
