如何在Django ORM中使用__in过滤时强制用JOIN替代子查询？

场景描述 #

需要获取所有关联项目标题匹配指定字符串的发票，Invoice与Project模型通过外键关联。希望复用Project模型中已封装的标题搜索逻辑，但直接使用project__in会生成低效的子查询，而直接编写project__title__icontains虽能生成高效JOIN，却无法复用已有逻辑。

原代码实现 #

Project模型自定义查询集方法 #

def search_title(self, title: str):
    """
    搜索标题包含指定内容的项目。
    """
    return self.filter(title__icontains=title)

Invoice模型自定义查询集方法 #

def search_project_title(self, project_title: str):
    return self.filter(project__in=Project.objects.search_title(project_title))

解决方案：复用查询条件而非查询集 #

核心是将Project的搜索逻辑封装为查询条件对象（Q对象），而非直接返回过滤后的查询集，这样既能复用逻辑，又能让ORM生成JOIN语句。

1. 修改Project模型的查询逻辑 #

新增方法返回查询条件，同时保留原有的search_title方法以兼容单独查询项目的场景：

from django.db.models import Q

def get_title_search_condition(self, title: str):
    """返回标题包含指定内容的查询条件"""
    return Q(title__icontains=title)

def search_title(self, title: str):
    """保留原方法，用于单独查询项目"""
    return self.filter(self.get_title_search_condition(title))

2. 修改Invoice模型的查询方法 #

复用Project的查询条件，通过外键前缀关联字段，让ORM生成JOIN：

def search_project_title(self, project_title: str):
    # 获取Project的查询条件
    project_q = Project.objects.get_title_search_condition(project_title)
    # 为条件中的字段添加外键前缀，转换为Invoice可使用的条件
    invoice_q = Q()
    for child in project_q.children:
        if isinstance(child, tuple):
            field, value = child
            invoice_q &= Q(**{f"project__{field}": value})
    return self.filter(invoice_q)

或者更简洁的字典展开写法：

def search_project_title(self, project_title: str):
    project_condition = Project.objects.get_title_search_condition(project_title)
    # 将条件字段转换为外键关联格式
    invoice_condition = {f"project__{k}": v for k, v in project_condition.children}
    return self.filter(**invoice_condition)

原理说明 #

直接使用project__title__icontains时，Django ORM会自动生成JOIN关联Project表。通过复用查询条件并添加外键前缀，本质上和直接编写project__title__icontains的逻辑一致，因此ORM会优先选择高效的JOIN而非子查询。

而原代码中project__in的方式，因传入的是完整查询集，Django默认会生成子查询（除非查询集结果极小），执行效率远低于JOIN。

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