Beego 的 ParseForm 不支持多层嵌套结构体自动绑定，因其底层仅用 url.ParseQuery 和字段名简单匹配，不递归解析点号路径（如 User.Profile.Avatar）；需手动扁平化表单为 JSON 再反序列化，或改用 JSON 提交。
Beego 中 ParseForm 不支持多层嵌套结构体自动绑定
Beego 的 ParseForm 默认只处理一级字段（如 User.Name 会被识别为 Name），对嵌套结构体（如 User.Profile.Avatar）直接忽略，表单值不会进入深层字段。这不是 bug，是设计限制——它底层用的是标准库 url.ParseQuery + 字段名简单匹配，不递归解析点号路径。
常见错误现象：User.Profile.Avatar 在 HTML 表单中写成 ，但后端 ctx.Input().ParseForm(&user) 后，user.Profile.Avatar 仍是空字符串。
- 必须手动展开嵌套，或改用其他绑定方式
- 不能依赖
ParseForm自动解包Profile这类匿名/嵌入结构体 - 如果结构体含指针字段（如
*Profile），默认更不会初始化，需提前分配
用 json.Unmarshal + 表单转 map 是最稳的绕过方案
把表单数据先转成 map[string][]string，再扁平化为 JSON 字符串（模拟 POST JSON），最后用 json.Unmarshal 绑定到嵌套结构体。这个流程绕开了 Beego 的解析限制，且能准确还原层级。
实操建议：
- 调用
ctx.Input().GetStrings()获取原始表单键值，或用ctx.Input().Data["form"]（需提前启用EnableDocs = true） - 写一个轻量函数把
map[string][]string转成扁平 key 的map[string]interface{}，例如"User.Profile.Avatar"→map["User"]["Profile"]["Avatar"] = "a.png" - 用
json.Marshal再json.Unmarshal，比手写反射更可靠，也兼容切片、时间、数字类型 - 注意：HTML 表单不传空字段，所以嵌套结构体字段若未提交，对应 JSON 中不会出现该 key，
json.Unmarshal不会覆盖原值（除非字段有omitempty）
示例关键片段：
// 假设 formMap 是从 ctx.Request.PostForm 拿到的 map[string][]string flatMap := flattenFormMap(formMap) // 自定义函数，按点号拆分并嵌套 jsonBytes, _ := json.Marshal(flatMap) json.Unmarshal(jsonBytes, &user)
自定义 Bind 方法时，别漏掉 time.Time 和 []string 的转换
如果选择封装自己的 BindNested 方法（基于反射），最容易翻车的是类型转换：Beego 表单值全是字符串，但目标字段可能是 time.Time、int64、[]string 或自定义类型。标准 ParseForm 对基础类型有简单支持，但嵌套后这套逻辑不触发。
-
time.Time字段必须显式指定格式，比如2006-01-02，否则time.Parse报错；建议统一用time.ParseInLocation+ctx.Input().Config.TimeFormat -
[]string字段（如多选 checkbox）在表单里是多个同名 key，但PostForm返回的是[]string，需判断字段是否为切片类型，再逐个赋值 - 嵌套结构体中含
interface{}或json.RawMessage时，无法靠字符串直转，得留接口让业务层预处理 - 性能上，反射绑定比 JSON 方案慢 3–5 倍（实测 100 字段嵌套结构），高并发场景慎用
前端命名要和后端结构体 tag 严格对齐，尤其注意大小写和下划线
Beego 不做字段名映射转换，ParseForm 和自定义绑定都依赖结构体 tag 中的 form key，例如 type User struct { Profile *Profile `form:"profile"` }，那 HTML name 必须是 profile.Avatar，而不是 Profile.Avatar 或 profile_avatar。
- Go 结构体字段首字母大写才可导出，但表单 name 应全小写 + 点号，和 tag 保持一致
- 如果用了
json:"avatar_url"但没写form:"avatar_url"，默认 fallback 到字段名AvatarUrl→avatarurl（全小写无分隔），极易错位 - 数组字段如
Tags []string `form:"tags"`，前端要发tags=go&tags=beego&tags=web，不是tags[]=go&tags[]=beego - 嵌套切片（如
Orders []Order `form:"orders"`）目前无通用解法，建议拆成独立 API 或改用 JSON 提交
复杂点始终在「嵌套 + 切片 + 自定义类型」三者叠加时——这时 JSON 提交 + ctx.Input().Bind（Beego 2.x）或直接 json.Decode 反而是最省心的选择。
