Django REST Framework中一对多关联的POST请求失败问题排查

我需要在API中实现添加带外键的记录功能：无需在关联表中创建新记录，仅关联现有记录的ID并保存。关联关系中，Acronym表与Scope表为外键关联。

现有GET请求返回格式符合预期：

{
    "acronym": "Commercial water large stock third letter. Democrat your goal run price. Record myself decision attorney give.\nBill around difficult west protect change every. Various history total particular painting. Mission himself car can of try ten.",
    "decleration": "Less.",
    "date": "1992-02-12",
    "scope": {
        "scope_id": 16
    }
}

期望POST请求使用以下格式：

{
    "acronym": "Hello",
    "decleration": "World",
    "date": "2010-07-05",
    "scope": {"scope_id" : 16}
}

视图代码（view.py）：

@api_view(['GET', 'POST'])
def acronym_list(request):
    if request.method == 'GET':
        acronyms = Acronym.objects.all()
        serializer = AcronymSerializer(acronyms, many=True)
        return Response(serializer.data)
    elif request.method == 'POST':
        serializer = AcronymSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

序列化器代码（serializer.py）：

class ScopeInsertSerializer(serializers.ModelSerializer):
    class Meta:
        model = Scope
        fields = ['scope_id']

class AcronymSerializer(serializers.ModelSerializer):
    scope = ScopeInsertSerializer(read_only=False)
    
    class Meta:
        model = Acronym
        depth = 1
        fields = ['acronym', 'decleration', 'date', 'scope']
  
    def create(self, validated_data):
        scope = validated_data.pop('scope')
        acronym = Acronym.objects.create(**validated_data)
        existing_scope = Scope.objects.get(scope_id=scope)
        acronym.scope = existing_scope
        acronym.save()

当前问题：POST请求能通过验证，但create函数中获取的validated_data里，scope是空的OrderedDict：

{'acronym': 'Hello', 'decleration': 'World', 'date': datetime.date(2010, 7, 5), 'scope': OrderedDict()}

你的核心问题是用嵌套序列化器处理外键关联时，未正确配置反序列化逻辑，导致DRF无法解析传入的scope_id，最终validated_data中的scope为空。具体原因和两种解决方案如下：

错误原因 #

1. 嵌套的ScopeInsertSerializer默认被DRF识别为需要创建新Scope实例的结构，但你实际只需要传递现有ID，且该序列化器未明确提取scope_id到validated_data中。
2. depth=1仅用于序列化时展开关联对象，反序列化时会干扰嵌套字段的解析逻辑。

方案一：使用PrimaryKeyRelatedField（简洁推荐） #

如果可以接受POST请求格式改为直接传递scope的ID：

{
    "acronym": "Hello",
    "decleration": "World",
    "date": "2010-07-05",
    "scope": 16
}

修改序列化器：

class AcronymSerializer(serializers.ModelSerializer):
    # 反序列化接受ID，序列化返回指定格式的scope对象
    scope = serializers.PrimaryKeyRelatedField(queryset=Scope.objects.all())

    class Meta:
        model = Acronym
        fields = ['acronym', 'decleration', 'date', 'scope']

    # 重写序列化逻辑，输出符合要求的格式
    def to_representation(self, instance):
        representation = super().to_representation(instance)
        representation['scope'] = {'scope_id': representation['scope']}
        return representation

无需自定义create方法，DRF会自动处理外键关联。

方案二：保持期望的POST请求格式 #

如果必须保留{"scope": {"scope_id":16}}的请求格式，修改序列化器如下：

class AcronymSerializer(serializers.ModelSerializer):
    # 自定义嵌套字段的反序列化规则
    scope = serializers.DictField(child=serializers.IntegerField())

    class Meta:
        model = Acronym
        fields = ['acronym', 'decleration', 'date', 'scope']

    def create(self, validated_data):
        scope_data = validated_data.pop('scope')
        scope_id = scope_data.get('scope_id')
        # 获取现有Scope实例
        existing_scope = Scope.objects.get(scope_id=scope_id)
        # 创建Acronym并关联外键
        acronym = Acronym.objects.create(scope=existing_scope, **validated_data)
        return acronym

    # 控制序列化输出格式
    def to_representation(self, instance):
        representation = super().to_representation(instance)
        representation['scope'] = {'scope_id': instance.scope.scope_id}
        return representation

或者也可以调整ScopeInsertSerializer实现：

class ScopeInsertSerializer(serializers.ModelSerializer):
    class Meta:
        model = Scope
        fields = ['scope_id']
        extra_kwargs = {'scope_id': {'required': True}}

class AcronymSerializer(serializers.ModelSerializer):
    scope = ScopeInsertSerializer()

    class Meta:
        model = Acronym
        fields = ['acronym', 'decleration', 'date', 'scope']

    def create(self, validated_data):
        scope_data = validated_data.pop('scope')
        scope_id = scope_data['scope_id']
        existing_scope = Scope.objects.get(scope_id=scope_id)
        acronym = Acronym.objects.create(scope=existing_scope, **validated_data)
        return acronym

    def to_representation(self, instance):
        representation = super().to_representation(instance)
        representation['scope'] = {'scope_id': instance.scope.scope_id}
        return representation

注意：需要移除原有的depth=1，改用to_representation控制输出结构。

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