c.FormFile 返回 nil 的主因是前后端编码不匹配，需确保前端用 multipart/form-data、后端未提前读取 body、字段名严格一致；保存用 c.SaveUploadedFile 更安全；限制上传需在 gin.New() 后设 MaxMultipartMemory。
上传文件时 c.FormFile 返回 nil 的常见原因
不是所有表单都能被 Gin 正确解析为文件，c.FormFile 返回 nil 通常是因为前端没发对、后端没配对。最常踩的坑是：前端用 application/json 发送二进制数据（比如 base64 字符串），而 Gin 的 FormFile 只处理 multipart/form-data 编码的原始文件字段。
必须确保：
- HTML 表单的
enctype属性设为"multipart/form-data" - 后端路由用
POST，且未提前调用c.ShouldBind或c.PostForm等会消耗 body 的方法 - 字段名与
c.FormFile("xxx")中的字符串完全一致（区分大小写）
接收单个文件并保存到本地的最小可行代码
Gin 自带 c.FormFile 和 file.Open 配合 os.Create 就能完成基础保存，不需要额外中间件或包。关键在于别漏掉错误检查和资源关闭。
示例：
func uploadHandler(c *gin.Context) {
file, err := c.FormFile("file") // 注意字段名要和前端一致
if err != nil {
c.JSON(400, gin.H{"error": "no file received or parse failed"})
return
}
dst := "./uploads/" + file.Filename
if err := c.SaveUploadedFile(file, dst); err != nil {
c.JSON(500, gin.H{"error": "save failed: " + err.Error()})
return
}
c.JSON(200, gin.H{"message": "uploaded", "path": dst})
}
c.SaveUploadedFile 是 Gin 封装好的安全方法，它内部做了权限检查和路径清理，比手动 os.Open + io.Copy 更稳妥。
限制上传大小和文件类型的安全实践
Gin 默认不限制上传体积，不加限制会导致内存暴涨甚至 OOM。限制必须在路由初始化阶段配置，不能靠 handler 内部判断——因为 body 已经被读取了。
正确做法是在 gin.New() 后立即设置：
r := gin.New() r.MaxMultipartMemory = 8 << 20 // 8 MiB，超出部分会写入临时磁盘 r.Use(gin.Recovery())
文件类型校验不能只看后缀名，要读取魔数（magic bytes）：
- 图片常见开头：
ff d8 ff（JPEG）、89 50 4e 47（PNG） - PDF：
25 50 44 46 - 用
file.Open()打开临时文件，读前 4–8 字节比对
注意：Gin 的 FormFile 返回的是 *multipart.FileHeader，它的 Size 字段可信，但 Header（即 MIME 类型）由客户端提供，不可信。
上传多个同名字段（如 input type="file" multiple）怎么处理
前端加 multiple 属性后，字段名不变，但后端不能再用 c.FormFile —— 它只取第一个。必须用 c.MultipartForm 手动遍历。
示例：
form, err := c.MultipartForm()
if err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
files := form.File["images"] // 注意这里返回 []*multipart.FileHeader
for _, file := range files {
if err := c.SaveUploadedFile(file, "./uploads/"+file.Filename); err != nil {
c.JSON(500, gin.H{"error": "save failed for " + file.Filename})
return
}
}
如果前端用了不同字段名（如 file1、file2），就分别调用 c.FormFile("file1") 和 c.FormFile("file2") 即可。但更推荐统一用 multiple + 同名字段，语义清晰且便于前端控制。
真正容易被忽略的是：Gin 不会自动清理临时文件，SaveUploadedFile 成功后，file 对应的临时磁盘文件仍存在，直到 Go 运行时 GC 触发或进程退出。高并发上传场景下建议用 os.RemoveAll(os.TempDir()) 定期清理，或改用内存缓冲（仅限小文件）。
