Header.Get("Content-Type")不可靠，因其由客户端设置，可能为空、伪造或与实际内容不符；应结合FileHeader.Filename提取原始文件名并用filepath.Base()和filepath.Ext()安全获取后缀，再通过MIME类型检测二次校验。
为什么 Header.Get("Content-Type") 不能可靠获取文件后缀名
上传文件时，客户端发来的 Content-Type 是由浏览器或调用方自行设置的，可能为空、伪造或不匹配实际内容。比如用户把 report.exe 改名为 report.jpg 后上传，Content-Type 可能仍是 image/jpeg，但实际是 PE 文件——仅靠它推导后缀名极不安全。
正确做法是结合 *multipart.FileHeader 的 Filename 字段解析原始名称，并辅以 MIME 类型检测（如 filetype 库）做二次校验。
-
FileHeader.Filename是客户端提交的原始文件名，含扩展名，但可能带路径（如C:\fakepath\avatar.png），需用filepath.Base()提取 - 用
strings.LastIndex()或filepath.Ext()获取后缀，注意filepath.Ext()对无点文件名（如README）返回空字符串 - 若需强校验，读取文件前若干字节，用
github.com/h2non/filetype检查真实类型，再映射到可信后缀（如filetype.JPEG→.jpg）
用 c.FormFile() 获取文件并提取后缀的典型流程
Gin 中处理上传文件最常用的是 c.FormFile("file")，它返回 *multipart.FileHeader 和 error。关键在于别直接信任 Filename 的全部内容。
// 示例：从表单字段 "file" 获取上传文件
file, err := c.FormFile("file")
if err != nil {
c.JSON(400, gin.H{"error": "no file uploaded"})
return
}
// 安全提取基础名和后缀
fileName := filepath.Base(file.Filename)
ext := strings.ToLower(filepath.Ext(fileName)) // 转小写便于比对
// 可选：白名单过滤
allowedExts := map[string]bool{".png": true, ".jpg": true, ".pdf": true}
if !allowedExts[ext] {
c.JSON(400, gin.H{"error": "unsupported file extension"})
return
}
-
filepath.Base()必须调用，否则 Windows 路径可能导致目录遍历（如../../etc/passwd） -
filepath.Ext()返回包括点的后缀（如.jpg），不是jpg，注意后续拼接逻辑 - 不要用
strings.Split()拆分Filename，它无法处理name.with.dots.txt这类合法文件名
重命名文件时避免冲突与覆盖的实用策略
用户上传同名文件会覆盖，生产环境必须重命名。常见错误是只加时间戳（time.Now().Unix()），在高并发下仍可能重复；或用 uuid.New() 但忽略存储路径安全。
- 推荐组合方式：
uuid.New().String() + ext（如"a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8.png"），保证全局唯一且无路径风险 - 若需保留原始语义（如用户 ID + 时间），可用
fmt.Sprintf("%d_%d%s", userID, time.Now().UnixMilli(), ext)，但务必确保userID可控、无非法字符 - 保存前检查目标路径是否存在？没必要——只要名字唯一，直接
c.SaveUploadedFile(file, dstPath)即可；存在则说明生成逻辑有 bug - 注意
dstPath必须是绝对路径或相对于可写目录的干净路径，禁止拼接用户输入的目录名
c.SaveUploadedFile() 的路径陷阱与权限问题
c.SaveUploadedFile() 内部调用 file.Open() 和 os.Create()，如果目标目录不存在或不可写，会静默失败或 panic（取决于 Gin 版本）。错误信息常被吞掉，只返回 no such file or directory。
- 务必提前创建目标目录：
os.MkdirAll("/data/uploads", 0755)，权限设为0755（非0777） - 不要用相对路径如
"uploads/" + newFileName，Gin 工作目录不确定；用filepath.Join(uploadDir, newFileName) - 若用容器部署，确认挂载卷有写权限，且
uploadDir在挂载路径内（如/app/data而非/tmp，后者可能被清理） - 保存后建议用
os.Stat()校验文件是否真实写入且大小非零，防止因磁盘满等导致静默截断
filepath.Base() 或漏了 os.MkdirAll()。 
