Django Rest Framework同一序列化器GET/POST请求返回格式不一致问题

核心原因 #

返回格式不一致的本质是POST请求对应的AuthorSerializer实际未触发你重写了to_representation的BookSerializer逻辑，常见触发场景如下：

• 你为POST单独定义的AuthorSerializer实际未绑定该自定义BookSerializer：很多开发者会单独定义可写的Book序列化器用于提交，容易出现绑定错误
• 视图层POST逻辑中，创建完Author实例后未重新从数据库拉取最新数据就直接序列化，此时多对多字段的缓存为原始提交的主键关联对象，未走自定义序列化逻辑
• 你在POST序列化器的create/update方法中手动处理书籍关联时，使用了字典格式的临时数据而非Book模型实例，导致to_representation接收的参数不是Book对象，自定义逻辑不生效
• GET查询时传入序列化器的是模型实例列表，POST返回时传入的是values()查询得到的字典列表，导致obj.title调用不生效，DRF fallback返回全字段字典

解决方法 #

1. 首先确认两个AuthorSerializer的books字段确实绑定的是同一个重写过to_representation的BookSerializer，不要混用其他序列化器
2. 如果是多对多字段缓存问题，在保存实例后手动刷新实例再序列化返回即可，示例代码如下：

# 视图层create方法示例
def create(self, request, *args, **kwargs):
    serializer = self.get_serializer(data=request.data)
    serializer.is_valid(raise_exception=True)
    instance = serializer.save()
    # 手动刷新实例，拉取最新的多对多关联数据
    instance.refresh_from_db()
    # 复用GET请求的序列化器做返回，保证格式统一
    return Response(AuthorSerializer(instance).data)

3. 给BookSerializer的to_representation加兼容逻辑，避免入参类型不符合时失效：

def to_representation(self, obj):
    if isinstance(obj, Book):
        return obj.title
    # 兼容字典类型入参的场景
    return obj.get('title', str(obj))

4. 如果需要同时支持books字段的读写，也可以直接用SerializerMethodField保证返回格式统一：

class AuthorSerializer(serializers.ModelSerializer):
    books = serializers.SerializerMethodField()

    class Meta:
        model = Author
        fields = ('books', ...)
        # 配置可写字段接收书籍ID提交
        extra_kwargs = {
            'books': {'write_only': True}
        }
    
    def get_books(self, obj):
        return list(obj.books.values_list('title', flat=True))

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