不能直接用 uuid.New() 生成文件名，因为其返回 uuid.UUID 类型而非字符串，直接拼接会出错或输出字节序列；必须调用 .String() 转为标准格式字符串。
为什么不能直接用 uuid.New() 生成文件名
因为 uuid.New() 返回的是 uuid.UUID 类型，不是字符串；直接拼接路径会触发类型错误或输出类似 {0x12 0x34 ...} 的字节序列。必须显式调用 .String() 方法转成标准格式（如 "f47ac10b-58cc-4372-a567-0e02b2c3d479"）。
另外，Gin 默认不自动解析 multipart 文件中的原始文件名编码（比如中文），c.FormFile() 拿到的 *multipart.FileHeader 的 Filename 字段可能已损坏，但重命名时其实不需要它——UUID 就是为避免依赖原始名而存在的。
如何在 Gin 中安全提取并保存上传文件为 UUID 名
核心步骤：解析表单、生成 UUID、构造新路径、保存文件。关键点在于别漏掉错误检查，尤其是磁盘写入权限和目标目录是否存在。
- 确保已导入
"github.com/google/uuid"（推荐 v1.3+） - 用
c.FormFile("file")获取上传项，其中"file"是 HTML 表单中<input type="file" name="file">的name值 - 调用
uuid.New().String()生成唯一文件名，建议拼上原始扩展名（从header.Filename安全提取） - 使用
os.MkdirAll()确保保存目录存在，避免open /upload: no such file or directory - 用
header.Open()获取文件流，再用io.Copy()写入新路径，别用header.Save()（它会保留原始名）
file, header, err := c.Request.FormFile("file")
if err != nil {
c.JSON(400, gin.H{"error": "no file uploaded"})
return
}
ext := filepath.Ext(header.Filename)
newName := uuid.New().String() + ext
dst := filepath.Join("./uploads", newName)
if err := os.MkdirAll("./uploads", 0755); err != nil {
c.JSON(500, gin.H{"error": "failed to create upload dir"})
return
}
out, err := os.Create(dst)
if err != nil {
c.JSON(500, gin.H{"error": "failed to create file"})
return
}
defer out.Close()
if _, err := io.Copy(out, file); err != nil {
c.JSON(500, gin.H{"error": "failed to save file"})
return
}
c.JSON(200, gin.H{"filename": newName})
要不要校验原始文件扩展名防恶意上传
要。仅靠 UUID 不能防止用户上传 .php 或 .exe 文件后通过其他方式执行。必须白名单校验扩展名，比如只允许 .jpg、.png、.pdf。
注意：filepath.Ext() 只取最后的点之后内容，攻击者可传 shell.php.jpg 绕过——应结合 mimetype 检查（用 file.Header.DetectContentType() 读前 512 字节）。
- 先用
file.Header.DetectContentType()获取真实 MIME 类型 - 再比对白名单，例如
"image/jpeg"、"application/pdf" - 拒绝
"text/php"、"application/x-executable"等高危类型 - 扩展名仅作辅助，不可单独依赖
并发上传时 UUID 会重复吗
不会。uuid.New() 默认生成 v4 UUID，基于加密随机数，碰撞概率低于 2^(-122)，在单机常规业务中可视为零。无需加锁或额外去重逻辑。
但要注意：如果用了 uuid.Must(uuid.Parse(...)) 这类解析已有字符串的函数，且输入不可控，就可能 panic——重命名阶段只用 uuid.New().String()，这是最安全的路径。
另外，别把 UUID 存进数据库后再查重——既没必要，又增加延迟和竞争风险。
