c.MultipartForm()不能直接处理多文件同名字段，因浏览器发送多个同名文件时标准库默认只取第一个；正确方式是循环调用c.FormFile()并以fh==nil为终止条件，且前端必须设enctype="multipart/form-data"和multiple属性。
为什么 c.MultipartForm() 不能直接处理多文件同名字段
很多人一上来就调用 c.MultipartForm()，发现 form.File["files"] 只返回一个 *multipart.FileHeader，误以为 Gin 不支持多文件上传。其实问题不在 Gin，而在 HTML 表单和 Go 标准库的约定：同名 <input type="file" name="files"> 多选时，浏览器会发多个同名字段，但 MultipartForm() 默认只取第一个。必须用 c.FormFile() 或手动遍历 form.File 切片才能拿到全部。
正确获取多个同名文件：用 c.FormFile() 循环调用
c.FormFile() 是 Gin 封装的便捷方法，它内部会自动查找所有同名文件头，比直接操作 MultipartForm 更可靠。关键点是：它不返回错误，而是返回 nil, nil 到达末尾 —— 这点容易被忽略，导致死循环或 panic。
实操建议：
- 用
for i := 0; ; i++循环，每次调用c.FormFile("files") - 检查返回的
*multipart.FileHeader是否为nil：是则说明没更多文件，break - 每次拿到
fh后立即调用c.SaveUploadedFile(fh, dstPath)保存，避免内存堆积 - 注意：不要在循环里重用变量名（比如都叫
fh）却不做非空判断，否则可能把上一轮的 header 当本轮用
for i := 0; ; i++ {
fh, err := c.FormFile("files")
if err != nil || fh == nil {
break // 没有更多文件或出错
}
dst := fmt.Sprintf("./uploads/%d_%s", i, fh.Filename)
if err := c.SaveUploadedFile(fh, dst); err != nil {
c.JSON(500, gin.H{"error": "save failed: " + err.Error()})
return
}
}
前端表单必须加 multiple 且禁用 enctype="multipart/form-data" 缺失
常见错误是写了 <input type="file" name="files"> 却没加 multiple 属性，或者忘了设 enctype。这时候即使用户 Ctrl+Click 选多个，浏览器也只发一个文件。
正确写法：
-
<form method="post" enctype="multipart/form-data"></form>——enctype缺失会导致后端收不到任何文件字段 -
<input type="file" name="files" multiple>——multiple是关键，没有它浏览器只允许单选 - 不要用
name="files[]"，Gin 不依赖 PHP 风格数组语法，纯 name 匹配即可
大文件或并发上传时，别忘了调 c.Request.ParseMultipartForm()
默认情况下，Go 的 ParseMultipartForm 只解析前 32MB 内存中的表单数据，超出部分会临时写入磁盘。如果上传多个大文件（比如每个 50MB），且没显式设置上限，可能触发 http: request body too large 错误，或因磁盘 I/O 拖慢响应。
解决方式是在路由 handler 开头加：
// 允许最多 200MB 表单数据（含文件+其他字段），内存限制 32MB，其余暂存磁盘
err := c.Request.ParseMultipartForm(200 << 20)
if err != nil {
c.JSON(400, gin.H{"error": "invalid form data"})
return
}
注意：ParseMultipartForm 必须在任何读取表单的操作（如 c.FormFile、c.PostForm）之前调用，否则无效。
实际部署时，Nginx 等反向代理也有 client_max_body_size 限制，这个值必须 ≥ Gin 设置的上限，否则请求根本到不了 Go 进程。
