DRF ModelSerializer文件上传报错及多文件上传问题求助

AI 小北

2026-5-12

解决DRF ModelSerializer文件上传的两个核心问题

问题1："too many values to unpack" 错误分析与修复

这个错误本质是因为你在BlogSerializer里把uploaded_files字段的source设为'*'，这会把整个序列化对象传递给FileField，而FileField只能处理单个文件对象，导致参数解析时出现解包错误。另外，你的create方法没有处理上传的文件，直接把所有validated_data传给BlogModel.objects.create()，但BlogModel根本没有uploaded_files这个字段，这也会引发后续问题。

修复步骤：

移除uploaded_files字段的source='*'配置，先让它正常接收文件；
重写create方法，单独处理上传的文件，创建对应的BlogFilesModel实例；
顺便修正BlogFilesModel的反向关联名称（避免和主模型的名称混淆）。

修改后的关键代码如下：

models.py（修正反向关联名称）

class BlogFilesModel(models.Model):
    # ...其他字段不变
    # 把related_name从'blogs'改成'blog_files'，语义更清晰
    blog = models.ForeignKey(BlogModel, on_delete=models.CASCADE, related_name='blog_files', blank=True)
    # ...其他字段不变

serializers.py（修正Serializer和create方法）

class BlogSerializer(ModelSerializer):
    blog_files = serializers.SerializerMethodField()
    # 移除source配置，让字段正常接收文件
    uploaded_files = serializers.FileField(required=True)
    blog_created_at = serializers.SerializerMethodField()

    # 保留你原来的get_blog_files和get_blog_created_at方法（这部分逻辑没问题）
    def get_blog_files(self, obj):
        info = BlogFilesSerializer(BlogFilesModel.objects.filter(blog=obj).order_by('-pk'), many=True)
        if info.data:
            user_detail = User.objects.get(pk=obj.user.id)
            user_data = UserSerializer(user_detail).data
            user_data.pop('password', None)
            for i in info.data:
                i['user_detail'] = user_data
        return info.data

    def get_blog_created_at(self, obj):
        return obj.created_at.strftime("%d-%m-%Y")

    class Meta:
        model = BlogModel
        fields = ('blog_id', 'user', 'title', 'content', 'status', 'blog_files', 'blog_created_at', 'uploaded_files' )

    def create(self, validated_data):
        # 先把上传文件从validated_data中取出，因为BlogModel不需要这个字段
        uploaded_file = validated_data.pop('uploaded_files')
        # 创建Blog主实例
        blog_instance = BlogModel.objects.create(**validated_data)
        # 创建对应的文件关联实例
        BlogFilesModel.objects.create(blog=blog_instance, path=uploaded_file)
        return blog_instance

问题2：支持多文件上传（添加multiple属性）

DRF的FileField默认不支持多文件选择，要实现这个功能，你需要用serializers.ListField包裹FileField，DRF的可浏览API会自动识别这个配置，显示支持多选的文件输入框；如果是自定义前端表单，只需给<input type="file">加上multiple属性即可。

修改`BlogSerializer`的`uploaded_files`字段：

class BlogSerializer(ModelSerializer):
    # ...其他字段不变
    # 用ListField包裹FileField，实现多文件上传支持
    uploaded_files = serializers.ListField(
        child=serializers.FileField(allow_empty_file=False, use_url=False),
        required=True
    )

    def create(self, validated_data):
        # 取出多文件列表
        uploaded_files = validated_data.pop('uploaded_files')
        blog_instance = BlogModel.objects.create(**validated_data)
        # 循环创建每个文件关联实例
        for file in uploaded_files:
            BlogFilesModel.objects.create(blog=blog_instance, path=file)
        return blog_instance

编辑1中的错误修复："files' is an invalid keyword argument for this function"

你给BlogModel添加了files属性，但BlogModel.objects.create()会把validated_data里的所有键当作模型数据库字段的参数，而files不是模型的数据库字段，所以会报错。

解决核心：不要把上传文件的字段和模型的非数据库字段绑定，而是像上面的方案一样，在create方法里手动取出上传文件的数据，不传递给BlogModel.create()。如果想保留files属性作为辅助，只需在create方法里先把files从validated_data中弹出即可。

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

DRF ModelSerializer文件上传报错及多文件上传问题求助

问题1："too many values to unpack" 错误分析与修复 #

修复步骤： #