Django中如何预取Event自定义方法过滤的关联Action

• 你当前调用的prefetch_related('actionsforevent')只会预取每个Event关联的全量Action数据，没有叠加active=True的筛选条件
• 你自定义的activeactions方法完全没有复用预取的关联缓存，而是直接执行独立的Action.objects.filter(event=self, active=True)查询，每遍历一个Event就会触发一次新的SQL，把预取的优化效果完全抵消了
• 原有的activeactions方法还有逻辑冗余：先执行一次查询判断数据是否存在，存在的话再执行一次查询取结果，光这一个方法就会给每个Event多触发两次重复SQL

1. 导入Django的预取控制对象 #

在视图或查询模块中导入Prefetch类，用来给关联预取过程添加自定义筛选逻辑：

from django.db.models import Prefetch

2. 改写Event的查询语句 #

使用自定义筛选后的Action查询集做预取，避免拉取全量Action数据：

# 定义只筛选激活状态Action的基础查询集，对齐原有业务的排序规则
active_action_queryset = Action.objects.filter(active=True).order_by('order', 'id')

events = Event.objects.filter(
    crisis=crisis,
    active=True
).prefetch_related(
    Prefetch(
        # 对应模型上外键的related_name
        'actionsforevent',
        # 预取时的自定义筛选逻辑
        queryset=active_action_queryset,
        # 把预取结果存到模型的自定义属性上，避免覆盖默认关联
        to_attr='prefetched_active_actions'
    )
)

这里to_attr的作用是隔离预取数据和模型默认的关联管理器，如果不设置这个参数，预取的筛选结果会直接覆盖原本的actionsforevent关联，可能影响其他需要读取全量关联Action的业务逻辑。

3. 优化原有activeactions模型方法 #

修改方法逻辑，优先读取已经预取好的缓存数据，不要再重复执行独立SQL查询：

class Event(models.Model):
    description = models.CharField(max_length=1000, blank=True)
    active = models.BooleanField(default=True)

    def activeactions(self):
        # 优先读取预取缓存
        if hasattr(self, 'prefetched_active_actions'):
            actions = self.prefetched_active_actions
        else:
            # 没有命中预取（比如单独查询单个Event的场景）时走正常ORM查询
            actions = self.actionsforevent.filter(active=True)
        # 空结果时返回None，和原有业务逻辑保持一致
        return actions if actions else None

• 整段查询逻辑总共只会触发2次SQL：第一次查询符合条件的Event列表，第二次一次性把所有关联的激活状态Action批量查出来，在Django内部通过event_id做关联映射，完全消除单个Event触发的重复查询
• 原有逻辑的冗余双查问题被解决，不管是命中预取缓存，还是单独调用方法查单个Event的激活Action，每个场景都只会触发一次必要的SQL
• 后续在模板、视图中直接调用event.activeactions()获取数据时，不会再触发额外的数据库查询

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