Django上传图片时如何保留原文件名覆盖同名文件？

问题根源在Django默认的FileSystemStorage——它检测到文件名冲突时，会自动给文件名追加随机后缀，哪怕你手动处理了文件覆盖，这个后缀还是会被加上。要解决这个，你需要自定义存储类，重写它生成可用文件名的逻辑。

步骤1：自定义存储类 #

创建继承自FileSystemStorage的类，重写get_available_name方法，让它直接返回原文件名（存在则先删除）：

from django.core.files.storage import FileSystemStorage

class OverwriteStorage(FileSystemStorage):
    def get_available_name(self, name, max_length=None):
        # 若文件已存在，先删除原文件
        if self.exists(name):
            self.delete(name)
        # 直接返回原文件名，不添加随机字符
        return name

步骤2：在ImageField中使用自定义存储 #

修改模型字段，指定使用上面的OverwriteStorage：

foto_content_url = models.ImageField(
    null=True, 
    blank=True, 
    upload_to=foto_path,
    storage=OverwriteStorage()
)

步骤3：修正你的foto_path函数 #

原函数存在语法错误，返回值格式不对，调整为符合Django要求的格式（可根据存储路径需求自定义）：

def foto_path(instance, filename):
    # 示例：将文件存储在photos目录下，文件名保留原名称并加上.jpg后缀
    # 注意不要以/开头，否则会从系统根目录开始存储
    return f"photos/{filename}.jpg"
    # 若不需要目录，直接返回文件名即可：
    # return f"{filename}.jpg"

设置完成后，上传同名文件时，Django会直接删除原文件并覆盖，同时保留原文件名，不会再追加随机字符。

注意：该操作会直接覆盖原文件，无版本保留机制，请确认业务逻辑允许后再使用。

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