如何在Django REST Framework中统计Supporters模型总数并返回给序列化器

需求：统计Supporters模型中所有支持者的总数，并将该统计值返回给序列化器。

原代码存在的问题 #

1. 序列化器中get_supporters_count方法错误定义在Meta类内部，该方法必须属于SupportersSerializer类的顶层成员。
2. obj.supporters_count无对应字段：Supporters模型未定义该关联字段，直接调用会触发AttributeError。
3. 视图类型不匹配：使用RetrieveAPIView（用于单对象查询）却返回多对象列表，应替换为ListAPIView。

方案1：在序列化器中添加全局总数字段（每个对象携带总数，不推荐） #

这种方式会导致每个对象序列化时都执行一次计数查询，性能较低，仅适用于小规模数据。

修改后的serializers.py：

from rest_framework import serializers
from .models import Supporters

class SupportersSerializer(serializers.ModelSerializer):
    id = serializers.ReadOnlyField()
    supporters_count = serializers.SerializerMethodField()

    class Meta:
        model = Supporters
        fields = ("id", "name", "img", "supporters_count")

    # 将方法移到Serializer类顶层
    def get_supporters_count(self, obj):
        # 直接查询模型总数量
        return Supporters.objects.count()

修改后的views.py：

from rest_framework import generics
from .models import Supporters
from .serializers import SupportersSerializer

class SupportersView(generics.ListAPIView):
    queryset = Supporters.objects.all()
    serializer_class = SupportersSerializer

方案2：视图中统一返回总数+列表（推荐，性能最优） #

仅执行一次计数查询，将总数和列表数据整合到响应中，更符合接口设计逻辑。

修改后的serializers.py（无需添加supporters_count字段，保持简洁）：

from rest_framework import serializers
from .models import Supporters

class SupportersSerializer(serializers.ModelSerializer):
    id = serializers.ReadOnlyField()

    class Meta:
        model = Supporters
        fields = ("id", "name", "img")

修改后的views.py：

from rest_framework import generics, Response
from .models import Supporters
from .serializers import SupportersSerializer

class SupportersView(generics.ListAPIView):
    queryset = Supporters.objects.all()
    serializer_class = SupportersSerializer

    def list(self, request, *args, **kwargs):
        # 调用父类方法获取列表数据
        list_response = super().list(request, *args, **kwargs)
        # 整合总数和列表数据
        return Response({
            "supporters_count": self.get_queryset().count(),
            "supporters_list": list_response.data
        })

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