Django Rest Framework同一Model如何仅用一个Serializer适配读写场景

完全可以只用一个Serializer满足读写需求，推荐优先使用重写to_representation方法的方案，不需要修改现有前端提交逻辑，也不需要维护重复的序列化器、视图集代码。

方案1：重写to_representation方法（推荐） #

该方案写入时保持默认逻辑，接受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):
        # 先获取默认的ID格式返回结果
        representation = super().to_representation(instance)
        # 替换关联字段为嵌套序列化内容
        representation['author'] = AuthorSerializer(instance.author, read_only=True).data
        representation['category'] = CategorySerializer(instance.category, read_only=True).data
        return representation

如果需要同时支持两种返回格式（部分场景返回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):
        representation = super().to_representation(instance)
        # 从上下文获取控制参数，默认返回嵌套格式
        if self.context.get("return_nested", True):
            representation['author'] = AuthorSerializer(instance.author, read_only=True).data
            representation['category'] = CategorySerializer(instance.category, read_only=True).data
        return representation

在视图中调用时，只需要通过上下文传入参数即可切换格式，示例：

# 返回ID格式的后台接口
class ManagePosts(viewsets.ModelViewSet):
    serializer_class = PostSerializer
    parser_classes = [MultiPartParser, FormParser]

    def get_serializer_context(self):
        context = super().get_serializer_context()
        context["return_nested"] = False
        return context

    # 其余原有逻辑保持不变

# 返回嵌套格式的前端接口
class FrontendPosts(viewsets.ModelViewSet):
    serializer_class = PostSerializer
    # 其余原有逻辑保持不变

方案2：分字段定义读写逻辑 #

如果需要明确区分读写字段，可以分别定义只读嵌套字段和可写ID字段，仅需要调整前端提交的字段名：

class PostSerializer(serializers.ModelSerializer):
    # 只读：返回嵌套对象
    author = AuthorSerializer(read_only=True)
    category = CategorySerializer(read_only=True)
    # 可写：接受ID值，写入时赋值给对应关联字段
    author_id = serializers.PrimaryKeyRelatedField(
        queryset=Author.objects.all(),
        write_only=True,
        source="author"
    )
    category_id = serializers.PrimaryKeyRelatedField(
        queryset=Category.objects.all(),
        write_only=True,
        source="category"
    )

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

使用该方案需要修改前端提交代码，把原来的category、author字段改为category_id、author_id：

formData.append('category_id', 1);
formData.append('author_id', userInfo.id);

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