根本原因是ParseMultipartForm未在读取request.Body前显式调用，导致req.MultipartForm为nil或panic；必须在req.FormValue、req.FormFile等任何body读取操作前调用，且参数建议显式传32
为什么 http.Request.ParseMultipartForm 会 panic 或丢文件
根本原因就一个：没调用，或调用太晚。Go 的 ParseMultipartForm 不是自动触发的，它必须在读取 request.Body 之前显式调用，否则后续访问 req.MultipartForm 或 req.FormFile 会 panic（http: multipart: Part.Read: no such file or directory），或者返回空文件。
常见错误场景包括：先写了 io.Copy 到磁盘、先调了 req.ParseForm()、或者把文件处理逻辑放在中间件里但没确保解析时机。
-
ParseMultipartForm必须在任何读取 body 的操作前调用，包括req.FormValue、req.FormFile、甚至io.ReadAll(req.Body) - 参数传
32 （32MB）比 <code>0更安全——0会让 Go 用默认 32MB 但不校验内存上限，容易 OOM；显式传值能触发早期拒绝超大请求 - 如果前端用了
enctype="multipart/form-data"但后端没调这个函数，req.MultipartForm就是nil，req.FormFile("file")会返回nil, err，且err是http.ErrNotMultipart
怎么安全地保存上传的文件到磁盘（含校验和防覆盖）
别直接用 req.FormFile("file").Filename 做本地路径名——它来自客户端，可被篡改为 ../../etc/passwd 或带 null 字节。真实路径必须由服务端生成，原始文件名只用于记录或响应。
核心动作是三步：打开临时文件句柄 → 复制数据 → 关闭并重命名。用 os.CreateTemp 而不是 os.OpenFile 拼路径，避免竞态和路径遍历。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
os.CreateTemp("", "upload-*.bin")创建唯一临时文件，返回*os.File和真实路径 - 用
io.CopyN(dst, src, maxFileSize)限制最大写入量，防止恶意大文件耗尽磁盘 - 保存完成后，用
os.Rename(tempPath, finalPath)原子替换——注意：同分区才原子，跨分区需io.Copy+os.Remove - 记得
defer f.Close()，但别 deferos.Remove(tempPath)——出错时才删，成功后要留着 rename
下载文件时为什么浏览器不弹保存框，或显示乱码
两个关键响应头缺一不可：Content-Disposition 和 Content-Type。漏掉 Content-Disposition: attachment; filename="xxx"，浏览器就当普通文本渲染；Content-Type 设成 application/octet-stream 最稳妥，避免 MIME 探测失败。
文件名里的中文必须用 filename*=UTF-8''xxx 编码，不能直接塞进 filename="中文.txt"，否则 IE/Edge 会乱码，Chrome 也可能截断。
- 设置头顺序无关，但必须在
WriteHeader或第一次Write之前完成 - 用
path.Base(filepath.Clean(name))过滤上传名中的路径字符，再用url.PathEscape编码为 URL 安全字符串，最后拼进filename*=UTF-8''... - 如果文件很大，别用
io.ReadAll加载进内存，改用http.ServeFile或io.Copy(w, f)流式传输
并发上传时 ParseMultipartForm 报 http: invalid Read on closed Body
这不是并发 bug，是误复用 http.Request。每个 HTTP 请求对应唯一 *http.Request 实例，它的 Body 是单次可读的 io.ReadCloser。一旦被某个 goroutine 调用过 ParseMultipartForm 或 io.Copy，其他 goroutine 再读就会报这个错。
典型错误是：在 handler 里启动 goroutine 异步处理文件，但没把需要的数据（如 multipart.File 句柄）提前复制出来，而是直接传了 req 或 req.MultipartForm 进去。
- 所有文件操作（
req.FormFile、multipart.File.Open）必须在 handler 主 goroutine 内完成，拿到multipart.File后，再用io.Copy或io.Read把内容读到[]byte或临时文件 - 如果真要异步，传的是已打开的
*os.File或bytes.Reader，不是req - 别依赖
req.Body多次读取——它不支持Seek，除非你自己 wrap 成io.Seeker
multipart 边界解析本身是线程安全的，但 body 流不是。问题从来不在并发，而在谁在什么时候碰了那个一次性管道。
