Django设置FileField多选属性后，多选文件仅上传单个的问题排查

逐环节检查没发现明显异常但只传上去一个文件，核心是三层配置的逻辑没有对齐——单独看每一步好像都符合Django的常规流程，串起来就会出现多文件丢失的问题：

• 模型层存储结构不支持多文件
  models.py里定义的photos是单值存储的FileField，天生只能存一个文件的路径，没有预留多文件的存储位置。哪怕前端选了再多文件，这个字段底层也没有空间放第二个文件的信息。
• 表单层没有适配多文件接收规则
  你虽然给widget加了multiple: True属性，让前端控件支持多选文件，但默认ModelForm绑定单FileField时，会严格按单文件逻辑处理上传请求：浏览器多选文件后会把所有文件用同一个photos字段名提交，此时request.FILES里的photos对应值是一个多文件组成的列表，但默认单文件字段只会从这个列表里取第一个文件赋值，剩下的文件直接被丢弃。
• 视图层没有做拆分落盘的逻辑
  默认的form.save()方法只会处理单文件字段的自动赋值，没有把拆分后的多文件逐个关联保存的逻辑。

第一步：调整模型存储结构 #

原来挂在主表上的单FileField承载不了多文件存储，最规范的实现是把文件字段拆成独立的关联模型，和主业务模型做一对多绑定，修改models.py：

class SchoolDocument(models.Model):
    apply_date = models.DateTimeField(_('Müraciət tarixi'))
    # 把原来写在主表上的单文件photos字段删除

class SchoolDocumentPhoto(models.Model):
    # 单独存上传照片的关联模型
    document = models.ForeignKey(
        SchoolDocument,
        related_name='photos',
        on_delete=models.CASCADE,
        verbose_name="所属申请单"
    )
    file = models.FileField(
        upload_to='static/school_documents/',
        blank=True,
        null=True,
        verbose_name="上传的照片文件"
    )

修改完记得执行makemigrations和migrate命令生成新的数据库表结构。

第二步：适配表单的多文件接收逻辑 #

修改forms.py，重写原来的单FileField字段，让表单能正常接住前端传上来的多文件列表，同时增加清洗逻辑把多文件解析出来：

from django import forms
from django.forms import ClearableFileInput, FileField
from .models import SchoolDocument

class CreateSchoolDocumentForm(forms.ModelForm):
    # 重写photos字段，开启多文件接收
    photos = FileField(
        widget=ClearableFileInput(attrs={'multiple': True}),
        required=False,
        label="上传申请照片"
    )

    class Meta:
        model = SchoolDocument
        fields = '__all__'

    def clean_photos(self):
        # 从请求里把所有同名的上传文件全部取出来，转成列表
        uploaded_files = self.files.getlist('photos')
        return uploaded_files

第三步：调整视图层的保存逻辑 #

原来直接调用form.save()的逻辑只能处理主表字段，需要把拆出来的多文件逐个做关联保存，修改views.py：

def school_document(request):
    if request.method == 'POST':
        form = CreateSchoolDocumentForm(request.POST, request.FILES, use_required_attribute=False)
        if form.is_valid():
            # 先把主表业务数据保存下来
            doc_instance = form.save()
            # 拿到清洗后的所有上传文件列表
            photo_list = form.cleaned_data.get('photos', [])
            # 逐个把文件关联到当前的申请单下
            for photo in photo_list:
                SchoolDocumentPhoto.objects.create(
                    document=doc_instance,
                    file=photo
                )
            return HttpResponseRedirect('school_document')
    else:
        form = CreateSchoolDocumentForm(use_required_attribute=False)
    context = {
        'form': form
    }
    return render(request, 'school_document.html', context)

你已经在html的form标签上加了enctype="multipart/form-data"，这个配置是正确的，不需要调整。改完上面的逻辑之后，按住Ctrl多选文件上传，所有选中的文件都会逐个关联保存到当前的申请单下。

如果不想拆关联模型临时省事，可以把原来主表上的photos字段改成JSONField类型，保存的时候把所有文件的路径存在列表里写入JSON字段，但这种方式后续要单独删除、下载某个文件的时候会比较麻烦，不建议长期使用。

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