Go ParseMultipartForm 的 maxMemory 不是总大小吗

不是。Request.ParseMultipartForm(maxMemory) 的 maxMemory 不是整个 multipart 请求体的总大小上限。它主要控制文件字段内容最多有多少字节优先留在内存；超过这部分预算的文件内容会落到临时文件，而普通字段、文件名、MIME 头和表结构本身仍然需要内存。要限制整个上传请求，应再给 r.Body 套上 http.MaxBytesReader。

先拆开 maxMemory 的三个边界

这个参数容易被误读，是因为它出现在处理上传的入口处，但它只参与 multipart 表单解析的内存预算。当前 Go 的 mime/multipart.ReadForm 文档把规则说得很清楚：文件内容最多按 maxMemory 字节存放在内存，不能放入内存的文件部分写入磁盘；非文件字段无法全部放入内存时，解析可能返回 ErrMessageTooLarge。

实现还为非文件数据预留了额外的 10 MB，并把字段名、文件名、MIME 头和 map 条目等元数据计入内存账本。因此，下面三件事不要混为一谈：

文件字段共享预算，超出部分会落到临时文件

假设传入 8 ，可以把它理解为“文件内容优先使用约 8 MB 内存”的预算，而不是“整个请求最多 8 MB”。如果一个文件有 20 MB，解析仍可能成功：前一部分文件内容留在内存，剩余部分在临时文件中；如果有多个文件字段，它们共同参与这次解析的文件内存预算。

这里还要留意文件句柄的生命周期。r.FormFile 返回的 multipart.File 可能对应内存中的文件内容，也可能对应临时文件。无论哪一种，都应该在读取结束后关闭它；如果解析阶段产生了临时文件，处理完整个表单后再调用 RemoveAll。

func readUpload(r *http.Request) ([]byte, string, error) {
    // 8 MB 是文件内容的内存预算，不是整个请求体上限。
    if err := r.ParseMultipartForm(8 

这个示例只适合已经有更小业务体积上限的场景。若文件可能很大，读取前应优先把总请求体限制住，并考虑直接流式复制到业务存储，避免把临时文件再次全部读入内存。

用 MaxBytesReader 限制整个请求体

如果目标是“一个上传请求最多允许 32 MB”，应该在调用解析函数之前限制 r.Body。这样限制的是整个请求体，而不是只限制文件内容在内存中的那一部分；普通字段、多个文件和 multipart 边界数据也会受到同一个总量上限约束。

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    const maxBody = 32 

MaxBytesReader 要放在读取 Body 之前；若等到 ParseMultipartForm 返回后才判断，解析工作已经发生了。它解决的是请求总量问题，maxMemory 解决的是解析阶段的内存/临时文件分配问题，两者应该同时按业务上限配置。

临时文件不是永久上传文件，RemoveAll 要放在清理边界

ParseMultipartForm 产生的临时文件只是解析过程的承载物。r.MultipartForm.RemoveAll() 会删除与表单关联的临时文件，但不会替你把文件复制到对象存储，也不会替你关闭已经由 Open 返回的文件句柄。因此常见的清理顺序是：打开文件、复制到业务存储、关闭句柄、删除表单临时文件。

如果业务要把上传内容保存到永久路径，应先完成复制再调用 RemoveAll；如果复制失败，也要让清理动作执行，避免临时目录残留。把 defer r.MultipartForm.RemoveAll() 放在解析成功后通常最稳妥。

整表解析和流式读取怎么选

整表解析的优点是可以直接通过 FormFile、MultipartForm.Value 和 MultipartForm.File 读取字段，适合字段数量有限、业务需要同时查看表单值和文件头的接口。它会先完整解析请求体，因此总量限制仍然要由 MaxBytesReader 提供。

如果上传对象很大、只需要按 part 顺序处理，官方建议使用 Request.MultipartReader 将请求体作为流处理。两种方式不要在同一个请求上混用：调用 MultipartReader 后再调用 ParseMultipartForm 会得到“multipart handled by MultipartReader”类错误。

一份可复用的判断清单

• 如果问题是“请求最多多大”，配置 MaxBytesReader，不要只调大或调小 maxMemory。
• 如果问题是“内存最多放多少文件内容”，配置 maxMemory，并把普通字段、文件名和 MIME 元数据的开销算进去。
• 如果问题是“临时文件为什么出现”，检查文件内容是否超过内存预算；这不一定意味着解析失败。
• 如果问题是“临时文件为什么没消失”，确认解析成功后是否调用了 MultipartForm.RemoveAll，以及打开的文件是否已经关闭。
• 如果问题是“大文件不想整表解析”，改用 MultipartReader，直接把每个 part 流式写入业务存储。

常见问题

maxMemory 设置成 1 MB，上传 10 MB 文件会直接失败吗？

不一定。文件内容超过内存预算时，超出的部分可以进入临时文件；是否最终失败还取决于总请求体限制、普通字段/元数据开销以及临时文件读写是否成功。

maxMemory 会限制所有文件加起来的大小吗？

它约束的是这次表单解析中优先放在内存里的文件内容预算，不是所有文件的总上传大小。多个文件会共同消耗这个内存预算，剩余内容可能落盘。

调用 FormFile 后还需要手动 ParseMultipartForm 吗？

如果没有提前解析，FormFile 会按默认内存预算触发解析。需要自定义内存预算或明确处理错误时，建议先显式调用 ParseMultipartForm，再调用 FormFile。

RemoveAll 会删除业务已经保存的文件吗？

它针对的是 multipart 表单解析关联的临时文件，不是你复制到业务目录或对象存储中的永久文件。业务存储仍由自己的路径和生命周期负责。