必须在读取 request.Body 前调用 ParseMultipartForm，因其会惰性解析并缓存 multipart 数据；若 Body 已被消费（如 io.ReadAll 或 FormValue 触发默认解析），后续调用将失败或返回空。
为什么 http.Request.ParseMultipartForm 必须在读取 request.Body 前调用
Go 的 HTTP 解析是惰性的，ParseMultipartForm 不仅解析表单字段，还负责把 multipart 数据从原始 request.Body 中提取出来并缓存到 Request.MultipartForm。一旦你手动调用 io.ReadAll(r.Body) 或用 r.FormValue（未解析时会自动尝试解析但有默认限制），Body 就被消费掉了，后续再调 ParseMultipartForm 会返回 http.ErrNotMultipart 或空数据。
- 必须在任何读取
Body的操作前显式调用r.ParseMultipartForm(32 （例如设 32MB 限制） - 若不设上限，Go 默认只解析前 10MB，超出部分会被丢弃且无提示
-
r.MultipartForm是解析后的结果，包含Value（普通字段）和File（文件句柄）两个 map
如何安全地保存上传的文件而不阻塞请求
直接用 file.Open → io.Copy 到磁盘是最常见做法，但要注意：文件句柄来自 r.MultipartForm.File，它底层是 multipart.File，本质是内存 buffer 或临时磁盘文件（取决于大小和 MaxMemory 设置）。不能在 handler 返回后继续读它。
- 调用
file, header, err := r.FormFile("file")后，立刻处理，不要 defer 关闭（可能已失效） - 避免用
os.Create写入固定路径，应生成唯一文件名（如uuid.New().String() + filepath.Ext(header.Filename)）防止覆盖或路径遍历 - 写入前检查
header.Size是否超出业务允许值，早失败比写一半再报错更可控 - 如需异步保存（比如转存到对象存储），应把
file内容完整读入[]byte或复制到bytes.Buffer，再启动 goroutine —— 原始file在 handler 结束后不可用
net/http.MaxBytesReader 对文件上传的实际作用是什么
它不是用来限制文件大小的，而是防止恶意客户端发送超长请求头或超大 body 导致内存耗尽。MaxBytesReader 包裹的是整个 request.Body，包括 multipart boundary、头部、所有字段和文件数据。如果你设了 32MB 限制，但用户上传一个 31MB 文件 + 大量文本字段，仍可能触发限制。
