Gin文件上传需处理边界情况：前端须用multipart/form-data编码且字段名匹配，否则c.FormFile返回nil；保存时禁用原始文件名防路径遍历，重命名并确保目录权限；须限制大小（如router.MaxMultipartMemory）和校验文件头类型。
Gin 里文件上传本身不难，难在边界情况没处理好——比如没限制大小、没校验类型、临时文件没清理，上线后直接被恶意上传打挂。
为什么 c.FormFile 拿不到文件？
常见原因是前端没用 multipart/form-data 编码，或者字段名对不上。Gin 不会报错，只会返回 nil, nil，容易误判为“没传”。
- 检查 HTML 表单是否设置了
enctype="multipart/form-data" - 确认
c.FormFile("file")中的"file"和前端的name完全一致（区分大小写） - 如果用了 Postman，选 Body → form-data，不要选 x-www-form-urlencoded
- 后端加一行日志：
files, _ := c.MultipartForm(); log.Printf("form keys: %v", files.File)，看字段是否真的进了表单
怎么安全地保存上传的文件？
别直接用 file.Filename 做本地路径名——它可能带 ../ 或空字节，有路径遍历风险；也别漏掉 os.Chmod，某些 Linux 环境下默认权限可能导致后续读取失败。
- 用
filepath.Base(file.Filename)截掉路径部分，再加随机前缀或 UUID 重命名 - 显式指定保存目录，用
os.MkdirAll(uploadDir, 0755)确保父目录存在 - 调用
file.Open()后必须defer src.Close()；dst, _ := os.Create(dstPath)后也要defer dst.Close() - 示例片段：
src, _ := file.Open() defer src.Close() dst, _ := os.Create(filepath.Join(uploadDir, newFilename)) defer dst.Close() io.Copy(dst, src)
如何限制上传大小和类型？
Gin 默认不限制 multipart 大小，攻击者发个 2GB 文件就能耗尽内存。类型校验不能只看后缀，得读文件头（magic number）。
- 全局设置：
gin.SetMode(gin.ReleaseMode); router.MaxMultipartMemory = 8 - 单路由控制更灵活：在 handler 开头加
c.Request.ParseMultipartForm(32 （32MB），失败时c.AbortWithStatusJSON(400, gin.H{"error": "file too large"}) - 类型判断别信
file.Header.Get("Content-Type")，浏览器可伪造；用bytes.ReadFull(src, head)读前 512 字节，再用http.DetectContentType(head)或匹配已知 magic（如 PNG 是89 50 4E 47） - 允许的类型列表建议硬编码，避免正则或模糊匹配
真正麻烦的不是上传动作本身，而是上传之后——临时文件残留、并发写同名文件、磁盘满时的降级策略、缩略图生成失败的回滚……这些 Gin 不管，得你一条条补上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
