Gin中需通过fileHeader.Open()读取前512字节，再用filetype.MatchReader()识别真实MIME类型，原始文件名须用filepath.Base()提取并重命名防路径穿越；分类存储应以检测出的MIME类型为依据，映射至对应子目录。
上传文件时如何获取原始文件名和 MIME 类型
Gin 的 c.FormFile() 只返回 *multipart.FileHeader，它不直接暴露原始文件名（可能被浏览器篡改）或真实 MIME 类型（Header.Get("Content-Type") 可伪造）。必须用 fileHeader.Open() 读取前几百字节，再调用 http.DetectContentType() 或更可靠的 filetype 库识别。
常见错误是直接信任 fileHeader.Filename 或 fileHeader.Header.Get("Content-Type")，导致恶意用户上传 shell.php.jpg 绕过校验。
- 用
filepath.Base(fileHeader.Filename)提取原始文件名，避免路径穿越（如../../etc/passwd） - 打开文件流后读取最多 512 字节，传给
filetype.MatchReader()（推荐 github.com/h2non/filetype） - 若检测失败（如空文件），回退到扩展名映射（需白名单，如
.pdf → application/pdf）
按 MIME 类型自动分目录存储的实现逻辑
分类不能只看扩展名，核心依据是检测出的 MIME 类型。例如 image/jpeg、application/pdf、text/plain 应分别存入 uploads/images/、uploads/docs/、uploads/text/。
注意 Gin 默认不限制上传大小，大文件会阻塞请求；且并发上传时多个 goroutine 写同一目录需确保目录存在——os.MkdirAll() 是安全的，但别在循环里反复调用。
- 建立 MIME 到子目录的映射表，例如
map[string]string{"image/": "images", "application/pdf": "docs"} - 匹配时优先全等（
"application/pdf"），再 fallback 到前缀匹配（"image/"） - 目标路径用
filepath.Join(uploadRoot, subDir, safeFilename)拼接，safeFilename需重命名（如加 UUID 前缀）防止冲突 - 写入前检查磁盘空间（
syscall.Statfs）和配额，避免填满根分区
如何在 Gin 中处理多文件上传并并发分类
c.MultipartForm() 返回的 *multipart.Form 包含 File 字段（map[string][]*multipart.FileHeader），对应 HTML 表单中 name="files" 的多个文件。Gin 不自动并发处理，需手动启 goroutine，但要注意上下文取消和错误聚合。
典型坑是未限制并发数，上传 100 个大文件时瞬间创建 100 个 goroutine，耗尽内存或触发系统 open files 限制。
- 用
sem := make(chan struct{}, 5)控制最大并发为 5 - 每个文件处理前
sem ，完成后 <code> - 用
errgroup.Group收集所有错误，任意一个失败可提前终止（根据业务需求） - 不要在 goroutine 中直接使用
c（*gin.Context不是线程安全的），只传必要参数：文件头、临时路径、配置项
为什么不能跳过临时文件保存直接流式分类
Gin 的 fileHeader.Open() 返回的是 io.ReadCloser，指向内存或临时磁盘文件（由 MaxMultipartMemory 决定）。如果文件 > 32MB（默认值），Gin 已将其写入 /tmp 临时文件；此时再读一遍是 IO 重复，但无法绕过——因为 filetype 等库需要 seekable stream 或完整字节。
有人尝试用 io.MultiReader 分流，但 multipart.FileHeader 不支持 rewind，读一次就 EOF。强行缓存全部内容到内存又违背大文件处理原则。
- 接受临时文件的存在，但设置
gin.SetMode(gin.ReleaseMode)并调大gin.DefaultWriter缓冲区 - 用
os.Rename()替代io.Copy()将临时文件移到目标位置（原子且零拷贝） - 定期清理
/tmp下过期的 Gin 临时文件（通过修改os.TempDir()并加 TTL 清理协程）
实际部署时，最易被忽略的是 MIME 检测的覆盖盲区：比如 .docx 文件常被识别为 application/zip（因其本质是 ZIP 包），这时要结合扩展名+魔数二次判断。别让分类逻辑变成单点故障。
