beego.Validation 不能复用到嵌套结构体，因其仅支持扁平字段校验，不递归校验子结构体字段，也无法保留完整字段路径用于错误提示；必须手动展开校验或改用 go-playground/validator/v10。
beego.Validation 为什么不能直接复用到嵌套结构体
beego.Validation 是早期 Beego 版本（v1.x）提供的轻量校验器，它只支持扁平字段级校验，valid.Required()、valid.Email() 等方法接收的是原始字符串或基本类型值，不识别结构体嵌套关系。当你把表单数据绑定到含嵌套字段的 struct（如 User{Profile: Profile{Email: ""}}）后，Validation 无法自动递归校验 Profile.Email，也不会触发 Profile 的非空判断。
常见错误现象是：嵌套字段为空但 valid.HasErrors() 返回 false；或者你手动传入 user.Profile.Email 做校验，但丢失了字段路径上下文，错误提示里只能显示 “Email” 而不是 “Profile.Email”，前端无法准确定位。
- 不要对嵌套 struct 整体调用
valid.Required(user.Profile, "Profile")—— 这只会检查指针是否为 nil，不校验内部字段 - 若必须用
validation，需手动展开：先校验user.Profile是否非 nil，再分别传入user.Profile.Email、user.Profile.Age等字段做独立校验 - 更推荐的做法是弃用
validation，改用标准库encoding/json+ 自定义Validate()方法，或切换至go-playground/validator/v10（需自行集成）
如何给 beego.Controller 添加运行时条件校验
Beego 默认的 ParseForm() 和 GetString() 只做字符串提取，不支持“当 type=invite 时 email 必填，否则忽略”这类逻辑。你得在 Post() 或 Put() 方法里手写分支判断。
典型场景：用户注册接口中，referral_code 字段存在时，需查数据库确认邀请人有效；不存在时跳过校验。
- 先调用
c.GetString("referral_code")获取值，再用if referral != ""包裹 DB 查询逻辑 - 查库失败时，不要直接
c.Abort("400")，而应收集进validation.Validation实例：valid.ErrorMap["referral_code"] = "邀请码无效"（注意：原生validation不暴露ErrorMap，需反射或 fork 修改源码；生产环境建议用自定义 error slice 替代） - 避免在
Prepare()中做此类校验——它早于ParseForm()，拿不到 POST 表单数据
替换默认校验器：接入 go-playground/validator/v10 的关键步骤
Beego 本身不绑定第三方校验器，但你可以完全绕过 validation，在 Controller 中直接使用 go-playground/validator/v10。它的 struct tag 支持 required_if、eqfield、unique 等高级规则，且错误对象自带字段名和翻译能力。
实操要点：
- 定义 struct 时用
validatetag：ReferralCode string `form:"referral_code" validate:"required_if=Type invite"` - 在 Controller 方法中调用：
err := validator.New().Struct(user)，而非依赖 Beego 内置解析 - 错误处理时，用
err.(validator.ValidationErrors)类型断言，遍历得到每个字段的Field()、Tag()和Value()，可精准返回 JSON 错误响应 - 注意：Beego 的
c.ParseForm(&user)仍要调用，否则 struct 字段不会被赋值；ParseForm和validator是两层独立逻辑
自定义校验函数如何注入 context 并返回字段级错误
比如你需要校验“手机号是否已被注册”，这必须查 DB，而 DB 查询需要 context.Context 和当前租户 ID。原生 validation 不支持传参，go-playground/validator 的自定义函数默认也不带上下文。
解决方案是封装一层校验入口：
- 定义函数签名：
func ValidatePhone(fl validator.FieldLevel) bool，但它拿不到ctx；所以改为在 Controller 内部构造闭包：validator.RegisterValidation("tenant_phone_unique", func(fl validator.FieldLevel) bool { return checkPhoneInTenant(fl, c.Ctx.Request.Context(), c.GetSession("tenant_id")) }) - 注册必须在每次请求中进行（不能全局注册），否则并发下
c会错乱 - 错误信息无法动态绑定字段名，需在闭包内手动拼接：
fl.Error() // 返回默认消息，或用fl.Top().StructNamespace()获取完整路径 - 真正复杂业务（如多租户+多语言+审计日志）建议放弃 tag 校验，改用命令式校验：先解包，再按业务流程逐字段判断，错误统一收集到 map[string]string
最易被忽略的一点：Beego 的 validation 没有 panic 保护，如果传入 nil 指针或未初始化的 struct 字段，运行时直接 crash；而 go-playground/validator 会静默跳过零值字段——这点在调试时特别容易卡住。
