c.FormFile("file")返回nil的主因是HTML表单缺少enctype="multipart/form-data"；需校验文件大小、清洗文件名、限定后缀并安全保存。
为什么 c.FormFile("file") 总是返回 nil？
不是前端没传，也不是字段名写错，大概率是 HTML 表单漏了 enctype="multipart/form-data"。Gin 不会报错，但 c.FormFile() 就会静默失败，返回 nil, nil —— 这是最常卡住的地方。
后端接收逻辑本身很简单：
file, err := c.FormFile("file")
if err != nil {
c.JSON(400, gin.H{"error": "no file received"})
return
}
但前提是：前端必须用正确方式提交。常见错误包括：
- 用
fetch或axios发送时没设Content-Type（其实不该设，让浏览器自动加） - 用
FormData.append("file", input.files[0])但表单<form>缺少enctype - 字段名（如
"file"）和前端实际 key 对不上，比如传了document却在后端查"file"
上传后怎么保存到服务器指定目录？
c.SaveUploadedFile() 是 Gin 封装好的快捷方法，本质是调用 file.Open() + io.Copy()，但它默认不做路径校验或重命名，直接拼接容易被绕过（比如传 ../../../etc/passwd）。
安全做法是：手动提取原始文件名、清洗、加随机前缀、限定后缀：
src, _ := file.Open()
defer src.Close()
filename := filepath.Base(file.Filename)
ext := filepath.Ext(filename)
safeName := fmt.Sprintf("%s%s", uuid.New().String(), ext)
dst := filepath.Join("./uploads", safeName)
out, _ := os.Create(dst)
defer out.Close()
io.Copy(out, src)
关键点：
- 别直接用
file.Filename拼路径，它可能含/或.. - 检查
ext是否在白名单内（如[".jpg", ".pdf"]），避免执行文件上传 -
./uploads目录需提前创建，否则os.Create()会报no such file or directory
如何限制单文件大小不超过 10MB？
Gin 默认只限制整个 HTTP 请求体（MaxMultipartMemory），不单独管单个文件。如果用户上传一个 50MB 的文件，服务可能 OOM 或超时，而不是返回 413。
必须显式检查 file.Size：
if file.Size > 10*1024*1024 {
c.JSON(400, gin.H{"error": "file too large (max 10MB)"})
return
}
注意：file.Size 是字节数，单位不是 KB；另外，这个判断要在 SaveUploadedFile 或 Open() 之前做，否则文件已读入内存。
补充建议：
- 在
gin.Default()前设置全局内存上限：gin.SetMode(gin.ReleaseMode); r.MaxMultipartMemory = 10 - 如果用 Nginx 反代，还得配
client_max_body_size 10M，否则请求根本到不了 Gin
上传成功后怎么返回文件访问 URL？
Gin 本身不提供静态文件服务，所以不能直接返回 http://host/uploads/xxx.jpg——除非你额外启用 r.Static() 并确保路径可公开访问。
推荐做法是：把文件存到独立可访问路径（如 ./static/uploads/），然后注册静态路由：
r.Static("/uploads", "./static/uploads")
之后返回 JSON 中的 URL 就是：
c.JSON(200, gin.H{
"url": "/uploads/" + safeName,
})
注意：
-
r.Static()的第一个参数是 URL 路径前缀，第二个是磁盘绝对或相对路径 - 别把上传目录设成
./或../，否则可能暴露源码 - 如果部署在子路径（如
/api/upload），URL 前缀也要同步调整
真实场景里，文件名去重、存储隔离、权限控制、清理策略这些都不会自动发生，得自己补全。单文件上传看着简单，一上线就容易在边界上出问题。
