必须在读取 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 文件 + 大量文本字段，仍可能触发限制。
- 它应在
http.Handler最外层包装，例如http.HandlerFunc(uploadHandler)套一层http.MaxBytesReader(nil, r.Body, 32 - 与
ParseMultipartForm的 limit 是两回事：后者控制解析缓存大小，前者控制总请求体字节数 - 触发时返回
http.StatusRequestEntityTooLarge（413），但错误发生在读 body 阶段，r.ParseMultipartForm根本不会执行
为什么本地测试上传大文件经常卡住或 408
默认 Go HTTP server 没有设置读超时（ReadTimeout），但某些代理（如 nginx）、浏览器或本地网络环境会在几十秒无响应后断开连接。更常见的是：你没调 ParseMultipartForm，又没读 Body，导致底层 TCP 连接 hang 在等待更多数据。
立即学习“go语言免费学习笔记（深入）”；
- 启动 server 时务必设置
http.Server.ReadTimeout和WriteTimeout（例如 5 分钟） - 确保前端
的enctype是"multipart/form-data"，漏写会导致后端收不到文件字段 - 用
curl -F "file=@/path/to/file" http://localhost:8080/upload测试最可靠，避免浏览器缓存或扩展干扰 - 日志里加一句
log.Printf("upload start, content-length: %s", r.Header.Get("Content-Length"))，能快速判断是前端没发还是后端卡死
MultipartForm 的临时文件默认存在 /tmp，如果磁盘满或权限不对，ParseMultipartForm 会静默失败 —— 这个点线上最容易被忽略。 
