根本原因是前端表单未设置enctype="multipart/form-data"，导致Gin无法解析二进制数据，c.FormFile返回nil；需检查HTML表单enctype、input name与c.FormFile参数一致，curl测试用-F而非-d。
上传文件时 c.FormFile 返回 nil 怎么办
根本原因是没在前端表单中设置 enctype="multipart/form-data"，Gin 无法解析二进制数据，c.FormFile 就会返回 nil 和错误。后端代码本身没问题，先检查 HTML 或 curl 请求头。
实操建议：
- HTML 表单必须带
enctype="multipart/form-data"，且<input type="file">的name属性值要和c.FormFile("xxx")中的字符串完全一致 - 用 curl 测试时，必须用
-F（不是-d），例如：curl -F "file=@/path/to/a.txt" http://localhost:8080/upload - 若上传多个同名文件（如多选上传），要用
c.MultipartForm()获取form.File["file"]切片，不能只调一次c.FormFile
保存上传文件前为什么要校验 size 和 Header
不校验就直接 file.Save()，可能被传入超大文件打爆磁盘，或上传可执行文件（如 .sh、.exe）造成服务端风险。Gin 默认不限制大小，需手动干预。
实操建议：
- 在调用
c.FormFile后立刻检查file.Size，例如限制 ≤20MB：if file.Size > 20*1024*1024 { c.AbortWithStatusJSON(400, gin.H{"error": "file too large"}) } - 不要只看后缀名，要读取文件头（
file.Open()后用io.ReadFull读前几个字节），比对 Magic Number，比如 PNG 是89 50 4E 47 - 用
filepath.Ext(file.Filename)提取扩展名时注意：攻击者可伪造filename="x.png.jpg"，所以应以实际检测的 MIME 类型为主，扩展名为辅
下载接口用 c.Header("Content-Disposition", ...) 不生效
常见错误是设置了 Header 却忘了调用 c.Data() 或 c.File()，或者顺序写反了——Header 必须在 c.Data 之前设置，且不能有其他响应体写入（比如提前 c.JSON）。
实操建议：
- 强制触发浏览器下载：用
c.Header("Content-Disposition", "attachment; filename="+url.PathEscape(realName))，其中realName是用户看到的文件名，必须用url.PathEscape处理中文或特殊字符 - 如果文件已存在本地路径，优先用
c.File("/path/to/file.zip")，它会自动设好 Content-Type 和 Content-Length；自己用c.Data时，务必手动设Content-Type（如application/zip）和Content-Length - 避免路径遍历：用户传来的文件名（如
../etc/passwd）必须过滤，建议用filepath.Base(name)取纯文件名，再拼到白名单目录下
并发上传时出现 too many open files
典型表现是上传几十个文件后接口卡住或报错，本质是每个 file.Open() 都打开一个文件描述符，但忘记 defer f.Close()，导致 fd 耗尽。Gin 的 c.FormFile 不会自动关闭底层文件句柄。
实操建议：
- 只要调了
file.Open()，就必须配对defer f.Close()，哪怕后续只是复制内容到新文件 - 用
os.CreateTemp代替直接os.Create("./uploads/"+filename)，避免竞态条件下的重名覆盖 - 生产环境务必设置系统级限制：
ulimit -n 65536，并在启动脚本里加GODEBUG=madvdontneed=1减少内存压力
