Django Rest Framework外键序列化器如何兼顾前端展示与后端读写需求

你遇到的是DRF开发中非常典型的外键字段读写需求不一致的问题，有两种成熟的解决方案可以选择：

方案1：单序列化器兼容读写（推荐小项目使用，代码量少） #

无需拆分两套序列化器，通过重写序列化输出逻辑实现读写兼容，前端写请求仍然传递author和category的ID值，返回结果自动转为嵌套对象格式：

class PostSerializer(serializers.ModelSerializer):
    class Meta:
        model = Post
        fields = ('category', 'id', 'title', 'image', 'slug', 'author', 'excerpt', 'content', 'status', 'published')
    
    # 重写序列化输出逻辑，将外键字段转为嵌套序列化格式
    def to_representation(self, instance):
        base_data = super().to_representation(instance)
        base_data['author'] = AuthorSerializer(instance.author).data
        base_data['category'] = CategorySerializer(instance.category).data
        return base_data

该方案不需要修改你的ViewSet代码，也不需要调整前端已有请求的传参结构，改造成本最低。

方案2：ViewSet动态切换序列化器（推荐中大型项目使用，逻辑更清晰） #

如果业务后续会有更多读写差异的自定义字段，可拆分读写两套序列化器，在ViewSet中根据请求方法自动切换：

步骤1：定义两套序列化器 #

# 读场景专用序列化器，返回嵌套结构
class PostReadSerializer(serializers.ModelSerializer):
    author = AuthorSerializer(many=False, read_only=True)
    category = CategorySerializer(many=False, read_only=True)    

    class Meta:
        model = Post
        fields = ('category', 'id', 'title', 'image', 'slug', 'author', 'excerpt', 'content', 'status', 'published')

# 写场景专用序列化器，接收ID值
class PostWriteSerializer(serializers.ModelSerializer):
    class Meta:
        model = Post
        fields = ('category', 'title', 'image', 'slug', 'author', 'excerpt', 'content', 'status', 'published')

步骤2：修改ViewSet动态选择序列化器 #

重写get_serializer_class方法，根据请求方法返回对应序列化器：

class ManagePosts(viewsets.ModelViewSet):
    parser_classes = [MultiPartParser, FormParser]

    def get_object(self, queryset=None, **kwargs):
        item = self.kwargs.get('pk')
        return get_object_or_404(Post, slug=item)

    def get_queryset(self):        
        return Post.objects.all()
    
    # 新增：动态选择序列化器逻辑
    def get_serializer_class(self):
        if self.request.method == 'GET':
            return PostReadSerializer
        # POST、PUT、PATCH等写请求使用写序列化器
        return PostWriteSerializer

该方案读写逻辑完全隔离，后续扩展功能不会互相影响，可维护性更高。

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