Django REST API中POST含ForeignKey的Artiste数据缺失关联字段问题

问题根源 #

你使用了嵌套序列化器处理外键关联，但嵌套序列化器默认是只读的，不会识别并处理传入的外键ID值；同时，嵌套结构要求传入关联对象的完整字段数据，而非单纯的ID，这就导致你提交的"nationnality":1被序列化器直接忽略了。

解决方案 #

根据你的需求（通过外键ID创建关联），以下是两种常用的处理方式：

方式一：同时支持外键ID写入+嵌套数据返回（兼顾读写场景） #

在ArtisteSerializer中同时定义外键ID字段和只读的嵌套序列化器，写入时用ID，返回时展示完整关联对象：

# serializers.py
from rest_framework import serializers
from .models import Artiste, Countrie

class CountrieSerializer(serializers.ModelSerializer):
    class Meta:
        model = Countrie
        fields = '__all__'

class ArtisteSerializer(serializers.ModelSerializer):
    # 用于写入的外键ID字段，指定查询集确保合法性
    nationnality = serializers.PrimaryKeyRelatedField(queryset=Countrie.objects.all())
    # 只读的嵌套字段，用于返回完整的国家数据
    nationnality_detail = CountrieSerializer(source='nationnality', read_only=True)

    class Meta:
        model = Artiste
        fields = ['id', 'name', 'nationnality', 'nationnality_detail']

此时POST请求提交{"name": "张三", "nationnality": 1}，validated_data中会正常包含nationnality对应的Countrie实例，能顺利创建Artiste对象；返回数据时会同时给出nationnality（ID）和nationnality_detail（完整国家信息）。

方式二：仅用外键ID序列化（简单场景） #

如果不需要返回嵌套的国家数据，直接去掉嵌套序列化器，使用默认的外键序列化逻辑即可：

# serializers.py
class ArtisteSerializer(serializers.ModelSerializer):
    class Meta:
        model = Artiste
        fields = '__all__'

这种情况下POST提交{"name": "张三", "nationnality": 1}，validated_data会正常包含nationnality字段。

方式三：保留嵌套序列化器并支持写入（需传完整对象数据） #

如果你确实需要通过嵌套结构写入数据，需要提交Countrie的完整字段数据，同时重写序列化器的create方法处理关联逻辑：

# serializers.py
class ArtisteSerializer(serializers.ModelSerializer):
    nationnality = CountrieSerializer()

    class Meta:
        model = Artiste
        fields = '__all__'

    def create(self, validated_data):
        # 取出嵌套的国家数据
        nationnality_data = validated_data.pop('nationnality')
        # 按需创建或获取已存在的国家对象
        nationnality, _ = Countrie.objects.get_or_create(**nationnality_data)
        # 创建艺人并关联国家
        artiste = Artiste.objects.create(nationnality=nationnality, **validated_data)
        return artiste

此时POST需提交如下格式的数据：

{
    "name": "张三",
    "nationnality": {
        "name": "中国",
        "code": "CN"
    }
}

验证方法 #

在视图中打印validated_data确认字段是否存在：

# views.py
from rest_framework import generics
from .models import Artiste
from .serializers import ArtisteSerializer

class ArtisteCreateView(generics.CreateAPIView):
    queryset = Artiste.objects.all()
    serializer_class = ArtisteSerializer

    def perform_create(self, serializer):
        print(serializer.validated_data)  # 现在能看到nationnality字段
        serializer.save()

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