Django文件上传时文件被自动重命名的问题求助

我之前也碰到过这个问题！当你强制只用TemporaryFileUploadHandler的时候，Django默认会把上传的文件重命名成随机临时文件名——这是因为这个处理器本来就是为了处理大文件、减少内存占用而设计的，默认逻辑就是把文件存到系统临时目录并替换原始文件名。下面给你几个实用的解决办法：

1. 视图层手动保留原始文件名 #

如果只是个别视图需要保留原始文件名，直接在视图里获取原始文件名，再手动把临时文件写入目标路径时用这个名称就行：

from django.http import HttpResponse
import os
from django.conf import settings

def upload_view(request):
    if request.method == 'POST' and request.FILES.get('my_file'):
        uploaded_file = request.FILES['my_file']
        # 获取用户上传的原始文件名
        original_name = uploaded_file.name
        # 定义存储路径，比如媒体目录下的uploads文件夹
        save_path = os.path.join(settings.MEDIA_ROOT, 'uploads', original_name)
        
        # 确保目标目录存在
        os.makedirs(os.path.dirname(save_path), exist_ok=True)
        
        # 把临时文件内容写入目标文件
        with open(save_path, 'wb+') as dest_file:
            for chunk in uploaded_file.chunks():
                dest_file.write(chunk)
        return HttpResponse("文件上传完成，已保留原始文件名")
    return HttpResponse("请选择要上传的文件")

⚠️ 注意：如果有重复文件名的情况，最好加个去重逻辑（比如在文件名后加序号），避免覆盖已存在的文件。

2. 自定义全局文件上传处理器 #

如果想让所有上传请求都自动保留原始文件名，可以自定义一个继承自TemporaryFileUploadHandler的处理器，修改它的文件名生成逻辑：

# 在你的app目录下创建handlers.py文件
from django.core.files.uploadhandler import TemporaryFileUploadHandler
import os
import uuid

class PreserveNameTempUploadHandler(TemporaryFileUploadHandler):
    def new_file(self, field_name, file_name, content_type, content_length, charset=None, content_type_extra=None):
        super().new_file(field_name, file_name, content_type, content_length, charset, content_type_extra)
        # 用原始文件名+随机后缀生成临时文件名，避免冲突
        temp_dir = self.file._dir
        base_name, ext = os.path.splitext(file_name)
        unique_name = f"{base_name}_{uuid.uuid4().hex[:8]}{ext}"
        self.file.name = os.path.join(temp_dir, unique_name)
        self.file.file = open(self.file.name, 'wb+')

然后在settings.py里替换默认处理器：

FILE_UPLOAD_HANDLERS = [
    'your_app_name.handlers.PreserveNameTempUploadHandler',
]

这个方法能全局生效，所有走这个处理器的上传都会保留原始文件名的核心部分，同时用随机后缀避免临时目录里的文件名冲突。

3. 模型层通过自定义存储类控制 #

如果是用Django模型的FileField/ImageField处理上传，可以自定义存储类来控制文件名：

from django.core.files.storage import FileSystemStorage
import os

class PreserveNameStorage(FileSystemStorage):
    def get_available_name(self, name, max_length=None):
        # 重写默认的文件名冲突处理逻辑，保留原始文件名（重复时加序号）
        if self.exists(name):
            base, ext = os.path.splitext(name)
            counter = 1
            while self.exists(f"{base}_{counter}{ext}"):
                counter += 1
            name = f"{base}_{counter}{ext}"
        return name

然后在模型里使用这个存储类：

from django.db import models

class UploadedFile(models.Model):
    file = models.FileField(
        storage=PreserveNameStorage(),
        upload_to='uploads/'
    )

这种方式适合用模型管理上传文件的场景，不需要在视图里写额外的文件操作代码。

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