Django上传阿拉伯语文件名文件无报错失败问题求助

问题描述 #

在Django中上传带阿拉伯语名称的文件时，文件未成功上传且无任何报错信息，核心调用代码为：form = UploadFileForm(data=request.POST, files=request.FILES)。

错误点排查 #

1. 表单验证失败无反馈：当form.is_valid()返回False时，代码直接执行重定向，无法看到表单错误信息，导致无法定位问题根源。
2. 文件字段赋值错误：portfolio.file= form.filename.decode('utf8')存在两处问题：
   • Django表单不存在filename属性，正确获取上传文件应使用form.cleaned_data['file']
   • 直接对文件对象执行decode('utf8')是错误操作，Django会自动处理文件编码，无需手动解码
3. 下载时文件名编码缺失：Content-Disposition头未对阿拉伯语文件名做编码处理，会导致下载时文件名乱码。

修复步骤 #

• 保留表单验证失败时的错误信息，返回原页面展示错误
• 修正文件字段的赋值逻辑，使用表单验证后的正确文件对象
• 对下载响应的Content-Disposition头进行编码，支持非ASCII文件名

修复后的代码 #

def upload_file(request):
    if request.method == 'POST':
        form = UploadFileForm(data=request.POST, files=request.FILES)
        if form.is_valid():
            portfolio = form.save(commit=False)
            portfolio.user = request.user 
            # 直接使用表单验证后的文件对象，无需手动解码
            portfolio.file = form.cleaned_data['file']
            portfolio.save()
            return redirect('upload_file')
        # 验证失败时返回原页面，携带表单错误信息
        return render(request, 'upload_file.html', {'form': form})
    else:
        form = UploadFileForm()
        files = UploadedBooksFile.objects.all()
        return render(request, 'upload_file.html', {'form': form, 'files': files})

def download_file(request, file_id):
    import urllib.parse
    uploaded_file = UploadedBooksFile.objects.get(pk=file_id)
    response = HttpResponse(uploaded_file.file, content_type='application/force-download')
    # 对阿拉伯语文件名进行URL编码，兼容主流浏览器
    encoded_filename = urllib.parse.quote(uploaded_file.file.name)
    response['Content-Disposition'] = f'attachment; filename*=UTF-8\'\'{encoded_filename}'
    return response

补充说明 #

• 确保你的UploadFileForm定义正确，示例如下：

from django import forms
from .models import UploadedBooksFile

class UploadFileForm(forms.ModelForm):
    class Meta:
        model = UploadedBooksFile
        fields = ['file']

• filename*=UTF-8''{encoded_filename}是符合RFC 5987标准的编码方式，Django 3.0+版本可完美兼容现代浏览器。

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