Django多对多配置prefetch_related后模板取首关联仍出现重复查询

• prefetch_related("categories")的工作逻辑是：一次性查询当前页所有Course对象关联的Category集合，把结果以Python列表形式缓存。当调用course.categories.all()时，会返回携带该缓存的QuerySet，不会触发额外SQL。
• 模板中使用的course.categories.first，经Django模板变量解析后，等价于直接调用多对多关联管理器（course.categories本身是RelatedManager实例，不是QuerySet）的first()方法。该方法会生成全新的、无预取缓存的QuerySet，执行带LIMIT 1的独立数据库查询，完全不会用到之前预取的缓存数据。因此每遍历一个课程对象就会触发一次单独查询，最终产生大量重复SQL。

方法1：直接复用带预取缓存的查询结果 #

预取完成后course.categories.all()返回的QuerySet已经携带缓存，可直接调用其相关方法取值，不会触发额外SQL。将原模板代码修改为以下任意一种均可：

<!-- 写法1：从缓存列表中按索引取第一个分类 -->
<div class="icon"><span class="{{ course.categories.all.0.icon }}"></span></div>

<!-- 写法2：调用带缓存的QuerySet的first方法 -->
<div class="icon"><span class="{{ course.categories.all.first.icon }}"></span></div>

如果存在无关联分类的课程，上述写法会返回空值，不会触发报错。

方法2：在Course模型中封装首个分类的属性 #

如果觉得模板内直接操作缓存的写法可读性差，可在Course模型中新增property方法，直接读取缓存数据：

class Course(ModelBase):
    # 原有字段保持不变
    @property
    def first_category(self):
        category_list = self.categories.all()
        return category_list[0] if category_list else None

模板中替换为调用该属性即可：

<div class="icon"><span class="{{ course.first_category.icon }}"></span></div>

该方式既保证了模板代码可读性，也完全复用预取缓存，不会产生额外查询。

方法3：优化分类筛选场景的逻辑 #

当视图传入category_id参数时，当前展示的所有课程都已经属于该指定分类，此时无需从课程关联关系中取分类图标，直接复用上下文里已经传入的current_category即可。模板中可增加分支判断：

{% if current_category %}
<div class="icon"><span class="{{ current_category.icon }}"></span></div>
{% else %}
<div class="icon"><span class="{{ course.first_category.icon }}"></span></div>
{% endif %}

该写法既减少了不必要的关联读取开销，也保证筛选场景下图标和当前选中分类一致。

• 当前视图的get_context_data中Category.objects.all()每次请求都会查询全部分类，可结合业务场景增加缓存，或复用已有的预取数据减少重复查询。
• 可使用Django Debug Toolbar验证优化后的SQL查询数量，确认预取逻辑正常生效。

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