如何正确序列化带有列表字段的QueryDict？

问题根源 #

URL里的ids=[1,2,3]会被DRF解析为字符串类型的'[1,2,3]'，而你使用的ListSerializer期望接收的是列表结构的数据，类型不匹配导致验证失败，抛出「必填字段」的错误（实际是数据类型不符合要求）。

解决方案 #

方案1：自定义字段处理字符串转列表

把字符串解析为列表的逻辑封装到自定义字段中，复用性更强：

from rest_framework import serializers
import ast

class StringToListField(serializers.ListField):
    def to_internal_value(self, data):
        # 如果传入的是字符串，尝试解析为列表
        if isinstance(data, str):
            try:
                data = ast.literal_eval(data)
            except (ValueError, SyntaxError):
                self.fail('invalid_list', input=data)
        # 调用父类方法完成后续验证（比如检查子元素是否为整数）
        return super().to_internal_value(data)

class EntityListSerializer(serializers.Serializer):
    ids = StringToListField(child=serializers.IntegerField())

方案2：在视图层提前解析参数

如果只需要在当前视图处理该逻辑，可以直接在视图里把字符串转成列表：

from rest_framework.response import Response
import ast

class EntityListView(BaseView):
    def get(self, request, *args, **kwargs):
        query_params = request.query_params.copy()
        if 'ids' in query_params:
            try:
                # 把字符串形式的列表解析为真实列表
                ids_list = ast.literal_eval(query_params['ids'])
                query_params['ids'] = ids_list
            except (ValueError, SyntaxError):
                return Response({"error": {"ids": "无效的列表格式"}}, status=400)
        
        request_serializer = EntityListSerializer(data=query_params)
        request_serializer.is_valid(raise_exception=True)
        # 后续业务逻辑
        ...

方案3：修改请求的参数格式（推荐）

遵循REST规范，用多值参数传递列表，比如把URL改为https://...entities/?ids=1&ids=2&ids=3。此时DRF的QueryDict会自动把ids解析为列表['1','2','3']，你的原有序列化器无需任何修改就能正常验证（IntegerField会自动把字符串转成整数）。

这种方式避免了字符串解析的潜在风险（比如恶意注入），是最规范的实现方式，如果前端可以调整请求格式，优先选择这个方案。

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