如何用Django ORM实现带额外匹配条件的left outer join？

场景背景 #

我们的Transaction实体采用EAV格式存储自定义属性，需要通过类似SQL中多次LEFT OUTER JOIN的方式将EAV数据与实体组装，流程如下：

• 先获取元数据映射，例如postalcode对应attribute_id=22，phone对应attribute_id=23；
• 基于元数据用Django ORM构建动态QuerySet，实现对eav_value表的多次左连，每次左连仅匹配对应attribute_id的属性值。

问题与报错 #

尝试在QuerySet的annotate中添加过滤条件来组装第一个属性时，代码如下：

transaction.annotate(
  postalcode=F('eav_values__value_text'), 
  filter=Q(eav_values__attribute_id__exact=22)
)

运行时抛出错误：AttributeError: 'WhereNode' object has no attribute 'select_format'，移除filter参数后错误消失，但无法过滤指定attribute_id的EAV值。

错误原因 #

annotate方法的参数是字段别名=查询表达式的键值对，你错误地将Q对象作为字段值传入（filter=Q(...)），而Q对象是用于构建WHERE条件的查询节点，并非合法的查询表达式，因此触发属性不存在的错误。

解决方案（无需原生SQL） #

以下几种Django原生ORM方法可实现目标SQL的左连逻辑：

方法1：使用FilteredRelation（推荐，Django 2.0+） #

FilteredRelation专门用于给关联表添加ON子句过滤条件，完全匹配目标SQL的左连逻辑：

from django.db.models import FilteredRelation, Q, F

# 1. 先获取基础QuerySet
base_query = Transaction.active_objects.filter(product_id=__PRODUCT_ID__).order_by('-id')

# 2. 定义带过滤条件的关联（对应SQL中左连eav_postalcode并添加attribute_id=22的ON条件）
base_query = base_query.annotate(
    postalcode_eav=FilteredRelation(
        'eav_values',
        condition=Q(eav_values__attribute_id=22)
    )
)

# 3. 从过滤后的关联中提取属性值
transaction_eav = base_query.annotate(
    postalcode=F('postalcode_eav__value_text')
).values('id', 'create_ts', 'postalcode')[27000:27002]

print(transaction_eav)

该方法生成的SQL会和你提供的目标SQL结构一致，多次添加FilteredRelation即可组装多个属性。

方法2：使用Case/When条件表达式 #

通过条件判断在annotate中筛选对应属性值，适合简单场景：

from django.db.models import Case, When, F, Value
from django.db.models.fields import TextField

transaction_eav = Transaction.active_objects.filter(product_id=__PRODUCT_ID__).order_by('-id').annotate(
    postalcode=Case(
        When(eav_values__attribute_id=22, then=F('eav_values__value_text')),
        default=Value(''),  # 无对应值时返回空字符串，也可设为None对应SQL NULL
        output_field=TextField()
    )
).values('id', 'create_ts', 'postalcode')[27000:27002]

注意：若一个实体对应多个同attribute_id的EAV值，需结合distinct()或聚合函数（如First）避免重复。

方法3：使用Subquery子查询 #

通过子查询直接获取对应属性值，适合仅需单个属性值的场景：

from django.db.models import Subquery, OuterRef
import eav_models

# 定义子查询：获取当前Transaction对应的postalcode属性值
postalcode_subquery = eav_models.Value.objects.filter(
    entity_id=OuterRef('id'),
    attribute_id=22
).values('value_text')[:1]  # 取第一个匹配值，避免多值问题

transaction_eav = Transaction.active_objects.filter(product_id=__PRODUCT_ID__).order_by('-id').annotate(
    postalcode=Subquery(postalcode_subquery)
).values('id', 'create_ts', 'postalcode')[27000:27002]

扩展：组装多个属性 #

以FilteredRelation为例，添加多个属性只需重复annotate步骤：

base_query = base_query.annotate(
    phone_eav=FilteredRelation(
        'eav_values',
        condition=Q(eav_values__attribute_id=23)
    )
).annotate(
    phone=F('phone_eav__value_text')
)

# 最终查询包含多个属性
transaction_eav = base_query.values('id', 'create_ts', 'postalcode', 'phone')[27000:27002]

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