如何避免Django模型中上传同名图片时被覆盖？

问题根源在于Django默认的ImageField处理上传文件时，若目标目录存在同名文件会直接覆盖。要避免这个问题，核心思路是为每个上传的文件生成唯一文件名，以下是几种实用的实现方式：

方法一：用UUID生成完全唯一的文件名 #

UUID是全局唯一标识符，能确保文件名绝对不重复，是最稳妥的方案：

首先导入必要模块，定义生成唯一路径的函数：

import os
import uuid
from django.db import models

def unique_album_image_path(instance, filename):
    # 分离文件名和扩展名
    _, file_extension = os.path.splitext(filename)
    # 生成UUID作为新文件名主体
    unique_filename = uuid.uuid4().hex + file_extension
    # 返回完整的上传路径
    return os.path.join("Album", unique_filename)

然后修改模型：

class AlbumImage(models.Model):
    album = models.ForeignKey(Album, on_delete=models.PROTECT, related_name="raters")
    image = models.ImageField(upload_to=unique_album_image_path)

方法二：结合时间戳生成唯一文件名 #

如果想让文件名带有时间信息，方便追溯上传时间，可以用精确到微秒的时间戳：

import os
from datetime import datetime
from django.db import models

def unique_album_image_path(instance, filename):
    _, file_extension = os.path.splitext(filename)
    # 生成精确到微秒的时间戳作为文件名
    timestamp = datetime.now().strftime("%Y%m%d%H%M%S%f")
    unique_filename = timestamp + file_extension
    return os.path.join("Album", unique_filename)

方法三：保留原文件名前缀+唯一标识 #

如果希望保留原文件名的部分信息，同时避免冲突，可以在原文件名前添加UUID或时间戳：

import os
import uuid
from django.db import models

def unique_album_image_path(instance, filename):
    file_name, file_extension = os.path.splitext(filename)
    # 生成唯一前缀+原文件名+扩展名
    unique_filename = f"{uuid.uuid4().hex}_{file_name}{file_extension}"
    return os.path.join("Album", unique_filename)

注意事项 #

• 以上修改仅对新上传的文件生效，已存在的旧文件不会受影响；
• 如果需要复用路径生成逻辑，可以用带@deconstructible装饰器的类实现，确保Django能正确处理模型迁移。

内容的提问来源于stack exchange，提问作者Mohammad AlQudah