如何在Django模型序列化器中高效添加自定义关联字段？

在Django REST Framework中，用SerializerMethodField给模型序列化器加自定义字段时，若涉及关联表查询，会为每条数据执行单独查询，引发N+1问题。比如现有如下ViewSet和Serializer：

class ProductViewSet(ModelViewSet):
    queryset = models.Product.objects.all()
    serializer_class = serializers.ProductSerializer
    ...

class ProductSerializer(ModelSerializer):
    class Meta:
        model = models.Product
        fields = "__all__"

需要为所有待序列化的Product添加关联Order的order_number字段，同时避免多次查询，寻求高效方案。

方法一：预关联查询 + 直接访问关联字段 #

如果Product和Order是一对一/外键关联（比如Product有order外键指向Order），用select_related预加载关联数据；如果是多对多/反向外键关系，则用prefetch_related。

1. 修改ViewSet的查询集 #

把关联数据提前加载，避免后续每条数据单独查询：

class ProductViewSet(ModelViewSet):
    # 一对一/外键用select_related，多对多/反向关系替换成prefetch_related("orders")
    queryset = models.Product.objects.all().select_related("order")
    serializer_class = serializers.ProductSerializer
    ...

2. 修改序列化器 #

直接通过关联对象的属性映射自定义字段，不需要SerializerMethodField：

class ProductSerializer(ModelSerializer):
    # 直接从预加载的order对象中取order_number
    order_number = serializers.CharField(source='order.order_number', read_only=True)

    class Meta:
        model = models.Product
        # 可以明确列出字段，或者保留__all__（会自动包含自定义的order_number）
        fields = ["id", "name", "price", "order_number"]

这种方式只会执行1次主表查询 + 1次关联表查询，彻底解决N+1问题。

方法二：用annotate批量注入字段 #

如果需要更复杂的关联计算（比如取每个Product的最新订单号、统计关联订单数量等），可以在数据库层面用annotate批量计算字段，直接在序列化器中映射。

1. 修改ViewSet的查询集 #

假设Product和Order是一对多关系（一个Product对应多个Order），要取每个Product的最新order_number：

from django.db.models import OuterRef, Subquery

class ProductViewSet(ModelViewSet):
    # 子查询获取每个Product的最新订单
    latest_order = models.Order.objects.filter(product=OuterRef('pk')).order_by('-created_at')
    # 用annotate把最新订单号注入到Product查询集中
    queryset = models.Product.objects.all().annotate(
        latest_order_number=Subquery(latest_order.values('order_number')[:1])
    )
    serializer_class = serializers.ProductSerializer
    ...

2. 修改序列化器 #

直接映射annotate生成的字段：

class ProductSerializer(ModelSerializer):
    order_number = serializers.CharField(source='latest_order_number', read_only=True)

    class Meta:
        model = models.Product
        fields = "__all__"

这种方式所有计算都在数据库层面完成，只执行1次查询，是性能最优的方案。

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