Django Rest Framework：按ID保存并返回关联模型全字段的方法

这个问题我之前也碰到过，用PrimaryKeyRelatedField确实能解决POST通过ID保存关联字段的需求，但GET只返回ID确实不够友好。给你几个实用的方案，都是基于ModelSerializer实现的，你可以根据自己的场景选择：

方案一：拆分输入输出序列化器 #

这是最直观的思路，把POST（写入）和GET（读取）用的序列化器分开，逻辑清晰，后期维护也方便。

假设你的主模型是Book，关联模型是Author，代码示例如下：

# 先定义关联模型的输出序列化器（用于返回完整字段）
class AuthorSerializer(serializers.ModelSerializer):
    class Meta:
        model = Author
        fields = '__all__'  # 或者指定你需要返回的具体字段，比如['id', 'name', 'birth_date']

# 用于POST/PUT/PATCH的输入序列化器（接受关联ID）
class BookInputSerializer(serializers.ModelSerializer):
    author = serializers.PrimaryKeyRelatedField(queryset=Author.objects.all())

    class Meta:
        model = Book
        fields = ['id', 'title', 'author']

# 用于GET的输出序列化器（返回关联模型的完整数据）
class BookOutputSerializer(serializers.ModelSerializer):
    author = AuthorSerializer()

    class Meta:
        model = Book
        fields = ['id', 'title', 'author']

然后在视图集中根据请求动作切换序列化器：

from rest_framework import viewsets

class BookViewSet(viewsets.ModelViewSet):
    queryset = Book.objects.all()

    def get_serializer_class(self):
        # 写入操作时用输入序列化器
        if self.action in ['create', 'update', 'partial_update']:
            return BookInputSerializer
        # 读取操作时用输出序列化器
        return BookOutputSerializer

方案二：在同一个序列化器里动态调整字段 #

如果不想写两个序列化器，可以在序列化器的__init__方法里，根据当前请求的方法动态修改字段类型：

class AuthorSerializer(serializers.ModelSerializer):
    class Meta:
        model = Author
        fields = '__all__'

class BookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = ['id', 'title', 'author']

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 从上下文获取当前请求对象
        request = self.context.get('request')
        if request and request.method in ['POST', 'PUT', 'PATCH']:
            # 写入请求时，用PrimaryKeyRelatedField接受ID
            self.fields['author'] = serializers.PrimaryKeyRelatedField(queryset=Author.objects.all())
        else:
            # 读取请求时，用嵌套序列化器返回完整数据
            self.fields['author'] = AuthorSerializer()

视图集里直接使用这个序列化器即可，无需额外切换：

class BookViewSet(viewsets.ModelViewSet):
    queryset = Book.objects.all()
    serializer_class = BookSerializer

方案三：重写to_representation方法 #

这种方式保持输入逻辑不变（用PrimaryKeyRelatedField接受ID），然后在序列化输出时手动替换关联字段为完整数据：

class AuthorSerializer(serializers.ModelSerializer):
    class Meta:
        model = Author
        fields = '__all__'

class BookSerializer(serializers.ModelSerializer):
    author = serializers.PrimaryKeyRelatedField(queryset=Author.objects.all())

    class Meta:
        model = Book
        fields = ['id', 'title', 'author']

    def to_representation(self, instance):
        # 先获取默认的序列化结果（此时author是ID）
        representation = super().to_representation(instance)
        # 把author字段替换为关联模型的完整序列化数据
        if instance.author:  # 避免关联对象为None时报错
            representation['author'] = AuthorSerializer(instance.author).data
        return representation

这三个方案都能满足你的需求，我个人更推荐方案一，输入输出分离的代码结构更清晰，后续扩展字段或者修改逻辑时不容易出错。如果是简单的小场景，方案三的代码量最少，也很省心。

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