c.FormFile()仅获取首个文件且触发一次性body解析，后续调用c.MultipartForm()会报错；应统一用c.MultipartForm()获取全部文件，校验非nil后遍历保存，并确保file.Open()配defer关闭及os.MkdirAll创建父目录。
如何用 c.FormFile() 获取单个文件但不阻塞多文件读取
直接调用 c.FormFile("files") 只会返回第一个匹配的文件，且 Gin 内部会一次性解析整个 multipart body —— 这意味着后续再调用 c.MultipartForm() 或反复调用 FormFile 会失败，报错 http: invalid Read on closed Body。
正确做法是只调用一次 c.MultipartForm()，从返回的 *multipart.Form 中提取全部文件：
form, err := c.MultipartForm()
if err != nil {
c.JSON(400, gin.H{"error": "parse form failed: " + err.Error()})
return
}
files := form.File["files"] // 注意：key 是表单字段名，值是 []*multipart.FileHeader 切片
- 确保前端
<input type="file" name="files" multiple>的name和后端 key 一致 - 不要混用
FormFile和MultipartForm；选一个，推荐后者 - Gin 默认限制 multipart 解析内存为 32MB（
gin.DefaultWriter配置），超限会 panic，需提前设gin.SetMode(gin.ReleaseMode)并捕获http.ErrBodyReadAfterClose类错误
保存文件时为什么 fileHeader.Open() 必须配对 defer f.Close()
*multipart.FileHeader 的 Open() 返回一个 io.ReadCloser，它底层可能持有临时文件句柄或内存 buffer。不显式关闭会导致文件句柄泄漏、磁盘空间被占满（尤其上传大文件时 tmp 目录堆积）、并发上传时 too many open files 错误。
典型错误写法：f, _ := fileHeader.Open(); io.Copy(dst, f) —— 缺少 f.Close()。
立即学习“go语言免费学习笔记（深入）”；
- 必须在每次
Open()后立即加defer f.Close()，哪怕后续有return - 不要把多个
Open()结果攒到一个for循环末尾统一关 —— defer 在函数 return 时才执行，中间已占用资源 - 如果要校验文件内容（如检查图片头），可在
Open()后用io.LimitReader(f, 1024)读前几 KB，避免全量加载
并发保存多个文件时，os.Create() 报 no such file or directory 怎么办
错误常出现在路径含子目录（如 "uploads/2024/06/"）时直接 os.Create(path)，而父目录尚未创建。Go 不会自动建多级目录。
正确做法是上传前先确保目录存在：
dstPath := filepath.Join("uploads", time.Now().Format("2006/01"), filename)
if err := os.MkdirAll(filepath.Dir(dstPath), 0755); err != nil {
c.JSON(500, gin.H{"error": "mkdir failed: " + err.Error()})
return
}
dst, err := os.Create(dstPath)
-
os.MkdirAll是幂等的，重复调用无副作用 - 权限建议用
0755（非0777），避免 web server 进程以外用户写入 - 若部署在容器中，确认挂载卷对目标路径有写权限，否则
MkdirAll成功但Create失败
前端传空文件数组或字段缺失时，form.File["files"] 是 nil 还是空切片
是 nil，不是 []*multipart.FileHeader{}。直接遍历 range form.File["files"] 会 panic：invalid operation: range of nil。
务必判空：
files := form.File["files"]
if len(files) == 0 {
c.JSON(400, gin.H{"error": "no files uploaded"})
return
}
for _, fileHeader := range files {
// ...
}
- 不能用
if files == nil判空 —— Go 中切片 nil 和 len==0 行为不同，但len(files)对两者都安全 - 浏览器未选任何文件时，
<input multiple>提交的表单中该字段根本不会出现，所以form.File["files"]为 nil - 测试时用 curl 模拟：
curl -F 'files=@a.txt' -F 'files=@b.txt' http://localhost:8080/upload，漏掉任一-F就会触发此问题
MultipartForm 结果展开，而不是反复试探性调用各种解析方法。 
