优化Django接口：减少获取关联Group名称的重复数据库查询

问题现状 #

当前代码存在两处明显问题：

1. 视图存在笔误：ZYX应为XYZ，itemId应为abcId；
2. 使用SerializerMethodField获取groupName时，每个XYZ实例都会触发一次数据库查询获取关联的Group名称，但请求过滤条件固定为指定abc和whse，返回的所有XYZ必然属于同一个Group，导致大量重复查询，造成性能浪费。

优化方案 #

方案一：视图预取Group名称，序列化器复用（当前场景最优）

利用过滤条件固定的特性，在视图中一次性获取对应Group名称，通过序列化器上下文传递给所有实例，彻底避免重复查询。

修改视图代码：

class XYZ_View(generics.ListAPIView):
    permission_classes = [IsAuthenticated]
    serializer_class = XYZSerializer

    def get_queryset(self):
        abcId = self.request.GET.get('abc')
        whseId = self.request.GET.get('whse')
        self.group_name = ''
        if abcId and whseId is not None:
            # 一次性获取ABC关联的Group名称
            try:
                abc = ABC.objects.select_related('group').get(id=abcId)
                self.group_name = abc.group.name
            except ABC.DoesNotExist:
                pass
            # 预取abc关联，避免序列化时的额外查询
            qs = XYZ.objects.filter(abc=abcId, whse=whseId).select_related('abc')
            return qs
        return XYZ.objects.none()
    
    def get_serializer_context(self):
        # 将Group名称传入序列化器上下文
        context = super().get_serializer_context()
        context['group_name'] = self.group_name
        return context

修改序列化器代码：

class XYZSerializer(serializers.ModelSerializer):
    groupName = serializers.SerializerMethodField()

    def get_groupName(self, instance):
        # 直接从上下文获取预取的Group名称，无需查询数据库
        return self.context.get('group_name', '')

    class Meta:
        model = XYZ
        fields = '__all__'

方案二：用select_related预取关联数据（通用适配方案）

如果后续过滤条件可能变化（比如允许返回多个abc对应的XYZ），可以通过select_related一次性预取所有关联层级的数据，解决N+1查询问题。

仅修改视图的get_queryset方法：

def get_queryset(self):
    abcId = self.request.GET.get('abc')
    whseId = self.request.GET.get('whse')
    if abcId and whseId is not None:
        # 预取abc及其关联的group，序列化时直接读取缓存数据
        qs = XYZ.objects.filter(abc=abcId, whse=whseId).select_related('abc__group')
        return qs
    return XYZ.objects.none()

序列化器代码无需修改，此时每个实例读取instance.abc.group.name时会使用预取的缓存数据，不会触发新的数据库查询。

方案对比 #

• 方案一：针对当前固定过滤条件的场景最优，仅执行1次Group查询，所有实例复用结果；
• 方案二：更通用，适配多种过滤场景，虽预取所有实例的关联数据，但也彻底解决了N+1问题。

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