DRF普通Serializer使用source映射JSON字段校验失败如何解决？

问题根因 #

你对source参数的作用场景理解有误：source仅控制序列化流程的字段映射逻辑，指定序列化器字段从待序列化的实例/对象中读取属性的路径。而在反序列化流程（即传入data参数实例化Serializer做输入校验）时，DRF默认仅会匹配你定义的序列化器字段名（示例中的my_field），不会识别source中配置的myOtherField，因此传入{'myOtherField': 'test2'}会触发my_field必填的校验错误。

你提到的不传data参数、直接将字典作为位置参数传入构造函数的场景，本质是走序列化流程而非反序列化流程，此时source会生效读取字典中对应键的值，因此可以正常运行。

解决方案 #

针对10~15个字段的批量映射需求，推荐以下两种方案：

方案1：使用alias参数（DRF 3.10+版本支持，单字段配置最简便） #

DRF原生提供alias参数专门用于指定反序列化阶段的入参别名，直接在字段上配置即可：

from rest_framework import serializers

class TestSerializer(serializers.Serializer):
    # alias指定反序列化时匹配的入参键名
    my_field = serializers.CharField(required=True, alias='myOtherField')

如果需要同时支持序列化阶段的属性读取，可搭配source参数使用：

my_field = serializers.CharField(required=True, alias='myOtherField', source='myOtherField')

方案2：重写to_internal_value方法（批量映射场景更易维护） #

如果需要映射的字段数量多，统一配置映射字典重写校验前置逻辑更方便维护：

from rest_framework import serializers

class TestSerializer(serializers.Serializer):
    my_field = serializers.CharField(required=True)
    another_field = serializers.IntegerField(required=True)
    # 其他需要映射的字段...

    # 映射字典规则：key为序列化器字段名，value为入参JSON的键名
    FIELD_MAPPING = {
        'my_field': 'myOtherField',
        'another_field': 'anotherJsonField',
        # 剩余10+字段直接在这里加就行
    }

    def to_internal_value(self, data):
        mapped_data = {}
        # 先处理映射字段
        for serializer_field, input_key in self.FIELD_MAPPING.items():
            if input_key in data:
                mapped_data[serializer_field] = data[input_key]
        # 保留不需要映射的字段，不需要可以删掉这段
        for k, v in data.items():
            if k not in self.FIELD_MAPPING.values():
                mapped_data[k] = v
        # 交给父类执行默认校验逻辑
        return super().to_internal_value(mapped_data)

测试验证 #

使用上述方案修改后，你的测试代码可正常运行：

test_data = {'myOtherField': 'test2'}
test = TestSerializer(data=test_data)
print(test.is_valid()) # 输出 True
print(test.validated_data) # 输出 {'my_field': 'test2'}

内容的提问来源于stack exchange，提问作者Shivendra Pratap Kushwaha