根本原因是HTML表单未设enctype="multipart/form-data"或前端未用FormData；需检查enctype、name一致、Content-Type自动设置；file.Open()必须调用，否则panic；文件名须净化或重命名防路径遍历；MaxMultipartMemory需手动调大。
上传文件时 c.FormFile 返回 nil 怎么办
根本原因是没在 HTML 表单里设置 enctype="multipart/form-data"，或者前端用 fetch / axios 时没构造正确的 FormData。Gin 不会自动解析普通 POST body 里的二进制数据。
检查点：
- HTML 表单必须带
enctype="multipart/form-data" - 用
axios时别手动设Content-Type，让它自动设置边界（否则c.FormFile拿不到） -
name属性值要和c.FormFile("xxx")里的字符串完全一致（区分大小写）
保存前必须调用 file.Open() 吗
是的。Gin 的 *multipart.FileHeader 只是元信息（文件名、大小、头信息），不是可读流。不调用 file.Open() 就直接 io.Copy 会 panic：「invalid argument」或空文件。
典型流程：
- 用
c.FormFile("file")获取*multipart.FileHeader - 立即调用
header.Open()得到multipart.File（本质是io.ReadCloser） - 用
os.Create()打开目标路径，再io.Copy(dst, src) - 务必
defer src.Close()和dst.Close()（后者尤其不能漏，否则文件可能写不全）
如何避免文件名被恶意覆盖或路径遍历
用户传来的 header.Filename 完全不可信。直接拼接会导致 ../../../etc/passwd 类攻击，或同名覆盖。
安全做法：
- 用
filepath.Base(header.Filename)剥离路径部分 - 用
strings.ReplaceAll清除控制字符、斜杠、点号等（如strings.Map(func(r rune) rune { if unicode.IsControl(r) || r == '/' || r == '\' { return -1 }; return r }, name)） - 更稳妥的是弃用原名，用
uuid.New().String() + filepath.Ext(name)生成新文件名 - 保存目录必须是预设的绝对路径（如
/var/uploads），禁止拼接用户输入的路径段
大文件上传时 Gin 报 http: request body too large
Gin 默认限制 32MB，超过就直接拒绝请求，连 c.FormFile 都不会执行。这不是业务逻辑问题，是 HTTP 层拦截。
解决方式是在初始化 gin.Engine 后立刻设置：
r := gin.Default() r.MaxMultipartMemory = 1024 << 20 // 1024 MB
注意单位是字节， 是 MB，<code> 是 GB；值设太大可能引发 OOM，建议按业务上限略放宽即可。
另外，Nginx 或其他前置代理也可能有 client_max_body_size 限制，需同步调整。
