如何在Django Rest Framework中序列化多对多对一关系

问题分析 #

你尝试用source="textbooks.etextbook"直接序列化关联的ETextBook，但报错的核心原因是：Author.textbooks是多对多管理器（ManyRelatedManager），它代表一组Textbook对象而非单个实例，因此无法直接链式访问仅属于单个Textbook的etextbook属性。

更简洁的实现方案 #

方案1：优化SerializerMethodField + 预取查询（推荐，解决N+1问题） #

原写法逻辑可行，通过预取关联数据可优化性能，同时保持代码简洁：

from django.db.models import Prefetch

class AuthorSerializer(serializers.ModelSerializer):
    etextbooks = serializers.SerializerMethodField()
    
    class Meta:
        model = Author
        fields = ("id", "textbooks", "etextbooks")

    def get_etextbooks(self, obj):
        # 从预取的textbooks中直接提取关联的etextbook，避免额外数据库查询
        etextbook_list = [textbook.etextbook for textbook in obj.textbooks.all() if hasattr(textbook, 'etextbook')]
        return ETextBookSerializer(etextbook_list, many=True).data

# 在视图层查询时添加预取配置：
queryset = Author.objects.prefetch_related(
    Prefetch('textbooks', queryset=Textbook.objects.select_related('etextbook'))
)

方案2：自定义可复用字段 #

如果该序列化场景需要在多处复用，可以封装成自定义字段：

class ETextBookRelatedField(serializers.RelatedField):
    def to_representation(self, value):
        # value为当前Author实例
        etextbooks = ETextbook.objects.filter(textbook__authors=value)
        return ETextBookSerializer(etextbooks, many=True).data

class AuthorSerializer(serializers.ModelSerializer):
    etextbooks = ETextBookRelatedField(read_only=True, source='*')
    
    class Meta:
        model = Author
        fields = ("id", "textbooks", "etextbooks")

方案3：嵌套序列化器间接获取 #

如果允许返回结构包含Textbook信息，可通过嵌套序列化器间接输出ETextBook：

class TextbookWithETextSerializer(serializers.ModelSerializer):
    etextbook = ETextBookSerializer()
    
    class Meta:
        model = Textbook
        fields = ("id", "etextbook")

class AuthorSerializer(serializers.ModelSerializer):
    textbooks = TextbookWithETextSerializer(many=True)
    
    class Meta:
        model = Author
        fields = ("id", "textbooks")

为什么期望写法无法运行？ #

DRF的source参数仅支持链式访问单个实例的属性/方法，而多对多字段返回的管理器对象本身没有etextbook属性——你需要遍历管理器中的每个Textbook实例，才能访问它们各自关联的ETextBook。

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