Django REST Framework中source反序列化POST数据失败原因及方案

问题原因 #

你搞混了DRF中source参数的作用，同时踩了Python保留字的坑：

1. source的核心用途是关联序列化器与模型字段，并非用来映射请求数据的键名到序列化器字段。当你写from_field = serializers.CharField(source='from')时，DRF会认为你要把模型里的from字段绑定到序列化器的from_field——但from是Python保留字，模型根本无法定义名为from的字段，这个配置本身就不成立。
2. 由于序列化器找不到source='from'对应的合法模型字段，验证阶段会判定from_field未收到有效值，因此抛出"字段必填"的错误。

可行替代方案 #

方案1：重写序列化器的to_internal_value方法 #

手动将请求里的from键值映射到序列化器的from_field，这是最直接的处理方式：

class TransferSerializer(serializers.ModelSerializer):
    from_field = serializers.CharField(required=True)

    class Meta:
        model = Transfer
        fields = ['from_field', 'to', 'amount']

    def to_internal_value(self, data):
        # 转移请求中的'from'值到'from_field'
        if 'from' in data:
            data['from_field'] = data.pop('from')
        return super().to_internal_value(data)

POST请求提交{"from": "user1", "to": "user2", "amount": 100}时，序列化器会自动把from的值赋值给from_field，再对应到模型的from_field字段。

方案2：视图层提前修改请求数据 #

如果不想改动序列化器，可以在视图的创建/更新方法里先处理请求数据：

class TransferCreateView(generics.CreateAPIView):
    serializer_class = TransferSerializer
    queryset = Transfer.objects.all()

    def create(self, request, *args, **kwargs):
        # 复制请求数据避免修改原始对象
        modified_data = request.data.copy()
        if 'from' in modified_data:
            modified_data['from_field'] = modified_data.pop('from')
        # 替换处理后的数据
        request.data = modified_data
        return super().create(request, *args, **kwargs)

方案3：使用Serializer手动处理（非ModelSerializer场景） #

如果不需要绑定模型，直接用基础Serializer，在create/update方法里手动取值：

class TransferSerializer(serializers.Serializer):
    from_field = serializers.CharField(required=True)
    to = serializers.CharField(required=True)
    amount = serializers.IntegerField(required=True)

    def create(self, validated_data):
        # 直接用validated_data里的from_field创建对象
        return Transfer.objects.create(**validated_data)

    def to_internal_value(self, data):
        # 映射请求的'from'到序列化器的from_field
        data['from_field'] = data.get('from')
        return super().to_internal_value(data)

注意事项 #

• 永远不要用Python保留字（如from、class、def）作为变量名、模型字段名，这会触发语法错误或各种隐性问题。
• DRF的source参数仅用于模型与序列化器字段的关联，不要用它来处理请求数据的键名映射。

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