c.FormFile是唯一触发multipart解析的入口，PostForm无法获取文件；SaveUploadedFile存在路径遍历、目录未检查、无前置校验三大风险，应手动Open+校验+流式写入，并调大MaxMultipartMemory和HTTP超时。
c.FormFile 是唯一能触发 multipart 解析的入口，其他方式拿不到文件内容；c.SaveUploadedFile 看似方便，但绕过校验、不防路径遍历、不检查目录存在性——生产环境直接用等于裸奔。
为什么 c.PostForm("file") 总是返回空字符串
因为 c.PostForm 只处理 application/x-www-form-urlencoded 或纯文本字段，对 multipart/form-data 中的文件字段完全无视。它不解析 multipart body，也不读取二进制流，所以你拿到的永远是空字符串或默认值，且无错误提示。
必须用 c.FormFile("file")，它才会：
- 首次调用时触发整个 multipart body 的解析
- 返回
*multipart.FileHeader，含Filename、Size、Header等元信息 - 后续再调用同名字段会返回
nil, error - 字段名必须和 HTML 表单中
<input type="file" name="avatar">的name属性完全一致，大小写敏感
c.SaveUploadedFile 的三个高危行为
它一行代码“搞定”上传，但实际跳过了所有可控环节：
- 文件名未过滤：前端传
../../etc/passwd会直接写入系统路径（路径遍历） - 目标目录未检查：若
./uploads不存在，c.SaveUploadedFile会静默失败并返回open ./uploads/xxx: no such file or directory - 无法前置校验：不能在保存前检查 MIME 类型、图片尺寸、是否含恶意 payload（比如木马图片）
更安全的做法是手动打开流 + 校验 + 写入：
file, err := c.FormFile("file")
if err != nil {
c.AbortWithStatusJSON(400, gin.H{"error": "no file received"})
return
}
src, err := file.Open()
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to open file"})
return
}
defer src.Close()
<p>if file.Size > 10<<20 { // 10MB
c.AbortWithStatusJSON(400, gin.H{"error": "file too large"})
return
}</p><p>dst, err := os.Create("./uploads/" + sanitizeFilename(file.Filename))
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to create file"})
return
}
defer dst.Close()</p><p>io.Copy(dst, src) // 或用 io.CopyN + limit reader 做流控
大文件上传必须调的两个配置项
Gin 默认限制 multipart 内存缓冲为 32MB，超大会直接 400；同时 HTTP 超时默认 30 秒，上传大文件必然超时。这两个参数必须显式调整：
-
gin.SetMode(gin.ReleaseMode)后，在router := gin.Default()之后立即设置：router.MaxMultipartMemory = 1024 - 启动服务时加超时控制：
server := &http.Server{Addr: ":8080", Handler: router, ReadTimeout: 5 * time.Minute, WriteTimeout: 10 * time.Minute} - 注意：
MaxMultipartMemory是内存缓冲上限，不是文件大小上限；真正限制大小得靠file.Size检查
上传性能瓶颈不在框架，而在 I/O 和内存模型
用 c.File() 下载大文件会全量读入内存再发，上传同理——c.SaveUploadedFile 本质也是先读进内存再写磁盘。真正的优化点是：
- 禁用
SaveUploadedFile，改用file.Open()+io.Copy流式写入，避免双缓冲 - 对上传流做限速（
io.LimitReader）或分块校验（如每 5MB 校验一次 magic bytes） - 并发上传多个文件时，别用
c.MultipartForm().File["files"]一次性加载全部 header，而应逐个c.FormFile+ 处理，减少内存峰值
最易被忽略的是：Gin 不会自动清理临时 multipart 缓冲，如果上传中断且没调 file.Open()，这部分内存可能滞留直到请求上下文销毁——这意味着超时配置和主动 abort 同样关键。
