beego valid验证常失效是因为未显式调用valid.valid()、字段缺失form标签、使用非导出字段或不支持的类型（如map）、json请求未手动解包校验，且不支持嵌套结构体递归验证。
Beego 的 Valid 结构体验证为什么常失效？
Beego 内置的 Valid 验证器默认只对结构体字段做基础校验（如 required、min、max），但不会自动触发——必须显式调用 valid.Valid()，且结构体字段需带 form 标签才能被绑定和验证。常见错误是直接解析 JSON 或表单后跳过校验步骤，或字段没加 form 标签导致 valid 完全不读取该字段。
实操建议：
- 定义结构体时，每个待验证字段必须有
form标签，例如：type UserForm struct { Name string `form:"name" valid:"Required;Min(2)"` } - 在 Controller 中，先用
this.ParseForm()（表单）或json.Unmarshal()+valid.Valid()（JSON），不能只解析不校验 -
valid不支持嵌套结构体递归验证；若字段是结构体类型，需手动展开或改用第三方库（如go-playground/validator） - 错误信息默认是英文，需提前调用
valid.SetMessage()替换，否则返回"The name field is required."这类提示
如何让 Beego 支持 JSON 请求体的字段级验证？
Beego 默认的 this.ParseForm() 只处理 application/x-www-form-urlencoded 和 multipart/form-data，对 application/json 无效。直接用 json.Unmarshal(this.Ctx.Input.RequestBody, &v) 解析后，必须手动传给 valid.Valid()，否则所有 valid: 规则都被忽略。
实操建议：
- Controller 中先解包 JSON 到结构体：
err := json.Unmarshal(this.Ctx.Input.RequestBody, &userForm) - 再显式校验：
valid := validation.Validation{}; ok, _ := valid.Valid(&userForm) - 注意：如果结构体字段名首字母小写（如
name string），valid无法反射访问——必须大写导出，且form标签要匹配实际 JSON key（如form:"user_name"对应{"user_name": "a"}） - 避免在
Prepare()里统一校验所有请求——不同 Action 的入参结构不同，校验逻辑应放在具体方法内
valid 的正则规则 Match 怎么写才不踩坑？
Match 要求传入 Go 原生正则语法，且必须用反斜杠双写（d 而非 d），否则编译失败或行为异常。常见错误是照抄 JavaScript 正则（如 ^d{11}$），忘记转义或缺少起止符。
实操建议：
- 手机号验证写成：
Phone string `form:"phone" valid:"Match(/^1[3-9]\d{9}$/)"`—— 注意^和$必须显式写出，\d是正确转义 - 邮箱验证别用复杂正则，Beego 自带
Email规则更稳：Email string `form:"email" valid:"Email"` -
Match错误时默认报"The phone field does not match the pattern."，建议用valid.SetMessage("phone", "手机号格式不正确")覆盖 - 正则中不要用
[u4e00-u9fa5]类 Unicode 范围——Beego 的Match底层用regexp.MatchString，虽支持 Unicode，但易因编码或空白干扰失败；中文校验优先用Alpha+Valid组合
验证失败后如何返回结构化错误给前端？
Beego 的 valid.Errors 是 []*validation.Error，每个元素含 Key（字段名）、Message（错误提示）、Field（结构体字段名）。直接返回 valid.Errors 会暴露内部字段名，且格式不统一。
实操建议：
- 手动映射错误到前端字段名：
errs := make(map[string]string); for _, e := range valid.Errors { errs[e.Key] = e.Message } - 配合 HTTP 状态码：验证失败用
this.Data["json"] = map[string]interface{}{"success": false, "errors": errs}; this.ServeJSON(); this.StopRun() - 不要把
valid实例作为全局变量复用——它不是线程安全的，每次请求必须新建validation.Validation{} - 如果用了自定义
SetMessage，确保 key 与结构体字段的form标签值一致，否则覆盖无效
Beego 的 valid 是轻量方案，适合简单场景；字段多、嵌套深、规则复杂时，硬塞 valid 反而增加维护成本——这时候该换 go-playground/validator 并自己封装 Bind+Validate 流程。
