如何在DRF中根据请求URL移除列表接口的contacts字段？

这问题我之前做项目时也碰到过，核心思路就是给ModelViewSet的列表操作和详情操作分别配置不同的序列化器——列表用轻量版（不含contacts），详情用完整版，完美解决性能问题。具体步骤如下：

1. 创建轻量版列表序列化器 #

先写一个只包含列表页需要字段的序列化器，去掉contacts字段：

class EmailListSerializer(serializers.ModelSerializer):
    class Meta:
        model = Email
        fields = ('id', 'contact_count')  # 只保留必要字段

2. 重写ViewSet的序列化器选择逻辑 #

修改你的EmailViewSet，通过get_serializer_class方法根据当前请求的动作（action）动态返回对应的序列化器：

class EmailViewSet(viewsets.ModelViewSet):
    # 默认使用列表序列化器
    serializer_class = EmailListSerializer

    def get_serializer_class(self):
        # 当请求是详情查询（retrieve）时，返回完整版序列化器
        if self.action == 'retrieve':
            return EmailSerializer
        # 其他动作（list/create/update等）用默认的列表序列化器
        return super().get_serializer_class()

额外性能优化（可选） #

如果你的contact_count是通过关联查询计算出来的，建议在列表查询时用annotate预计算，避免N+1查询问题，进一步提升列表接口速度：

from django.db.models import Count

class EmailViewSet(viewsets.ModelViewSet):
    serializer_class = EmailListSerializer

    def get_queryset(self):
        queryset = Email.objects.all()
        # 列表页预计算contact_count，不用每个实例单独查关联
        if self.action == 'list':
            queryset = queryset.annotate(contact_count=Count('contacts'))
        return queryset

    def get_serializer_class(self):
        if self.action == 'retrieve':
            return EmailSerializer
        return super().get_serializer_class()

这样配置后：

• 访问api/emails/（列表接口）时，只会返回id和contact_count，不会加载大量contacts数据，响应速度会快很多；
• 访问api/emails/<email_id>/（详情接口）时，会自动切换到EmailSerializer，展示完整的contacts列表。

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