ParseMultipartForm 不解析嵌套字段，仅将 multipart 数据扁平化为 map[string][]string，如"user.profile.name"不会自动映射到User.Profile.Name；需手动解JSON或用结构体绑定库。
Go 的 ParseMultipartForm 为什么解析不出嵌套字段？
因为 ParseMultipartForm 只负责把 multipart 数据按 key 拆成扁平的 map[string][]string，它根本不认识结构体、嵌套、切片或指针——更不会递归解析 JSON 或点号路径。你传一个 user.profile.name 这样的表单项，它就原样存成 key "user.profile.name"，不会自动塞进 User.Profile.Name 字段里。
常见错误现象：err == nil，但结构体所有字段都是零值；用 json.Unmarshal(r.PostFormValue("data")) 手动解 JSON 是可行的，但前提是前端把整个对象序列化成单个字段，这和“原生 multipart 表单提交”不是一回事。
- 真正能用的路径是：先调
r.ParseMultipartForm(32 ，再手动从 <code>r.MultipartForm.Value或r.MultipartForm.File里取原始键值 - 如果表单字段名带点号（如
address.city），别指望标准库自动映射——得自己写逻辑拆解 - 注意
ParseMultipartForm的参数是最大内存缓存字节数，设太小会触发磁盘临时文件，影响性能；设0会直接 panic
如何把 multipart.Form 映射到含 slice 和 struct 的 Go 结构体？
没有内置方案，得靠反射 + 规则匹配。核心思路是遍历 r.MultipartForm.Value 的每个 key，按分隔符（比如 . 或 [）拆出路径，再逐级定位结构体字段并赋值。字符串、数字、布尔值可以转，文件得单独处理（走 r.MultipartForm.File）。
使用场景：管理后台上传带多图、多联系人、地址列表的表单；API 兼容老式 HTML 表单而非纯 JSON。
- 字段标签用
form:"name"而非json:"name"，避免和 API JSON 解析冲突 - 切片字段需约定命名，例如
hobbies[0]、hobbies[1]，否则无法推断长度和顺序 - 嵌套 struct 字段名必须导出（首字母大写），且类型不能是 interface{} —— 反射无法设置未指定具体类型的字段
- 数字类型建议用
strconv.Atoi/strconv.ParseFloat，别用fmt.Sscanf，后者对空字符串 panic
mime/multipart.Reader 直接解析比 ParseMultipartForm 更可控吗？
是的，尤其当你需要跳过某些大文件、提前校验字段、或处理超长表单时。ParseMultipartForm 是“全量加载”，而 multipart.NewReader 允许流式读取每个 part，边读边判断：是普通字段就解析，是文件就丢弃或另存，甚至遇到非法 key 就直接中断。
性能影响明显：上传 100MB 文件时，若只关心几个文本字段，用 ParseMultipartForm 会先把整个 body 缓存（内存 or 临时文件），而流式解析可控制在几 KB 内存占用。
- 关键步骤：用
multipart.NewReader(r.Body, boundary)→r.NextPart()循环 → 判断part.FormName()→ 根据 name 分流处理 - 注意
part.Header.Get("Content-Disposition")里可能含 filename，但标准库不帮你解析，得手动 parsefilename="xxx" - 不要在循环里反复调
r.ParseMultipartForm，它只能调一次，重复调会返回http.ErrNotMultipart
容易被忽略的边界：文件字段和同名文本字段共存时怎么办？
HTML 表单允许 <input type="file" name="avatar"> 和 <input type="text" name="avatar"> 同时存在，此时 r.MultipartForm.Value["avatar"] 和 r.MultipartForm.File["avatar"] 都可能非空。标准库不报错，但你的反射映射代码如果只查 Value，就会漏掉文件；如果只查 File，又会丢文本。
这也是为什么不能依赖单一映射逻辑——必须同时检查两个 map，并按业务规则决定优先级（比如“有文件就忽略同名文本”或“文本作为文件备注”）。
- 安全起见，对每个字段名，都应显式检查
len(r.MultipartForm.Value[key]) > 0和len(r.MultipartForm.File[key]) > 0 - 如果字段定义为
*os.File或[]byte，就只取File；如果定义为string，就只取Value；如果是自定义结构体字段，得看业务语义 - 别忘了
defer part.Close()—— 流式解析时漏关 part 会导致连接 hang 住
复杂点不在反射本身，而在 multipart 协议天然的扁平性和 HTML 表单的随意性之间那层薄薄的映射逻辑。没人替你定义 profile[0].phone 到 Profile[0].Phone 的转换规则，连分隔符用点还是中括号都得前后端对齐。
