Go multipart.Form.RemoveAll 为什么要手动调用

multipart.Form.RemoveAll 要解决的不是 Go 内存回收，而是磁盘临时文件清理。ReadForm 会把无法放进内存预算的文件部分写入系统临时目录；这些文件属于返回的 Form，用完后应调用 RemoveAll 删除。

官方地址：https://pkg.go.dev/mime/multipart

问题现场：请求结束了，临时文件为什么还在

我第一次追这个问题时，直觉上以为 maxMemory 是上传体积上限。实际并不是：它主要控制文件部分有多少留在内存，放不下的文件内容会落到磁盘。于是程序逻辑已经处理完，临时目录里却仍可能存在解析阶段创建的文件。

关键观察点不是 FileHeader.Size，而是文件部分的实际存储位置。官方文档说明，multipart.File 的内容可能在内存，也可能在磁盘；落盘时底层具体类型会是 *os.File。这正是 RemoveAll 存在的原因。

初步判断：maxMemory 不是完整请求大小限制

Reader.ReadForm(maxMemory) 会解析整个 multipart 消息。官方文档说明，文件部分最多有 maxMemory 字节存于内存，超出的文件部分写入磁盘；非文件字段另有保留预算。因此：

• maxMemory 不等于“客户端最多只能上传这么多”。
• 限制整个 HTTP 请求体，应在解析前配合 http.MaxBytesReader。
• 只要解析可能落盘，就必须考虑临时文件清理。

动手验证思路：看 Form 拥有哪些资源

Form.Value 保存普通字符串字段，Form.File 保存文件头；每个 FileHeader 再关联内存数据或磁盘文件。RemoveAll 只负责删除这个 Form 关联的临时文件，不会删除你复制到业务目录或对象存储中的最终文件。

也不要把 file.Close() 和 form.RemoveAll() 当成同一件事：前者关闭一次 Open 得到的句柄，后者清理解析器创建的临时文件。两者通常都需要，但职责不同。

定位原因：谁创建 Form，谁就要确认清理责任

最容易混淆的是标准 HTTP 服务端。调用 r.ParseMultipartForm 后，net/http Server 会在处理器返回后清理请求上的 MultipartForm。所以在普通 http.Server 处理器里，不是每次都非得重复手动调用。

但这个自动行为不能推广到所有场景。你若直接创建 multipart.Reader 并调用 ReadForm，或者在测试、邮件解析、自定义协议、非标准服务循环中得到一个 *multipart.Form，标准 HTTP Server 就不会替你收尾。此时 Form 的创建者必须显式安排 RemoveAll。

修复方案：成功拿到 Form 后立刻 defer

package upload

import (
    "fmt"
    "mime/multipart"
)

func parseAndUse(mr *multipart.Reader) error {
    // 允许一部分文件内容留在内存，超出的部分可能进入临时目录。
    form, err := mr.ReadForm(8 

如果业务需要感知清理失败，不要忽略错误，可以把函数改为命名返回值，在 defer 中用 errors.Join 合并处理错误与清理错误。重点是：只有 ReadForm 成功返回非空 Form 后，才有对象可供清理。

HTTP 处理器里怎样写得更稳

func upload(w http.ResponseWriter, r *http.Request) {
    // 先限制整个请求体；maxMemory 本身不是上传总量上限。
    r.Body = http.MaxBytesReader(w, r.Body, 32

不要在异步 goroutine 还准备读取上传文件时提前调用 RemoveAll。更稳妥的做法是：在处理器生命周期内把内容复制到你管理的存储，再让临时 Form 按期清理；不要把临时文件路径当作持久化地址。

复查结果：一张清单判断是否会泄漏

• 代码是否直接调用了 multipart.Reader.ReadForm？如果是，成功后应立即安排 defer form.RemoveAll()。
• 是否只设置了 maxMemory，却没有限制整个请求体？HTTP 场景补上 MaxBytesReader。
• 是否把 File.Close 当成删除临时文件？关闭句柄后仍要确认 Form 的清理责任。
• 是否把临时文件交给异步任务？先复制到业务管理的路径或存储，再结束请求。
• 是否需要记录清理错误？按业务要求返回、合并或记录 RemoveAll 的错误。

常见问题

问：只上传小文件，还需要 RemoveAll 吗？
调用方不应依赖“这次肯定不落盘”的偶然情况。直接使用 ReadForm 时统一 defer，代码更可靠。

问：RemoveAll 会删除我保存到目标目录的文件吗？
不会。它删除的是 Form 关联的解析临时文件；你主动复制或创建的业务文件不属于这个集合。

问：调用两次 RemoveAll 会怎样？
不要把重复调用当常规控制流。把清理责任放在一个明确位置，避免多个层级争抢同一资源的所有权。