如何在调用Django序列化器前预取关联数据以减少查询次数？

你遇到的是典型的N+1查询性能问题——每个Coop实例序列化时都会单独查询关联的coopaddresstags_set及地址层级数据，导致查询次数随结果数量线性增长。可以通过Django的prefetch_related结合select_related实现批量预取，把查询次数固定为常数。

核心解决方案：预取所有关联数据 #

在自定义Manager的find方法中，给返回的查询集添加预取配置，一次性加载所有需要的关联数据，避免序列化时重复查询。

1. 修改find方法的查询集

引入Prefetch对象，指定预取coopaddresstags_set时同时加载关联的地址层级（外键关联用select_related，反向多对多用prefetch_related）：

from django.db.models import Q, Prefetch  # 新增Prefetch导入

class CoopManager(models.Manager):
    def find(
        self,
        partial_name,
        types_arr=None,
        enabled=None,
        city=None,
        zip=None,
        street=None,
        state_abbrev=None
    ):
        """Lookup coops by varying criteria."""
        q = Q()
        # 原有的Q条件逻辑保持不变...
        
        # 修改queryset，添加预取配置
        queryset = Coop.objects.filter(q).prefetch_related(
            # 预取coopaddresstags_set，并嵌套加载地址层级
            Prefetch(
                'coopaddresstags_set',
                queryset=CoopAddressTags.objects.select_related(
                    'address__locality__state__country'
                )
            ),
            # 如果序列化器用到了types多对多，也可以加上预取
            'types'
        ).select_related(
            # 如果序列化器用到了phone/email外键，添加select_related
            'phone',
            'email'
        )
        
        print(queryset.query)
        return queryset

2. 序列化器无需额外修改

当查询集已经预取了coopaddresstags_set及关联地址后，序列化时调用instance.coopaddresstags_set.all()会直接使用缓存的数据，不会触发新的数据库查询。

原理说明 #

• prefetch_related：用于处理多对多、反向外键这类跨表关联，会执行额外的批量查询并把结果缓存到对象中。
• select_related：用于处理正向外键关联，通过SQL JOIN一次性加载关联数据，适合层级嵌套的外键（如address__locality__state__country）。
• Prefetch对象：允许自定义预取的查询集，在这里我们指定预取CoopAddressTags时同时加载所有地址层级，避免每个地址再单独触发查询。

效果验证 #

修改后，查询日志会变成：

1. 一次查询获取所有符合条件的Coop记录
2. 一次批量查询获取所有关联的CoopAddressTags记录
3. 一次JOIN查询获取所有关联的Address、Locality、State、Country数据

无论返回多少条Coop结果，只会执行这几次固定的查询，彻底解决N+1问题。

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