Django中子查询无结果时，如何用filter+first()替换filter+distinct()

核心思路是利用Django的Exists子查询判断带日期过滤的结果是否存在，再通过Case-When在数据库层面动态切换查询逻辑，避免提前执行QuerySet导致的问题。

步骤1：定义基础查询片段 #

先保留原有的日期过滤条件，再分别构造带过滤和不带过滤的查询：

from django.db.models import Exists, Case, When, CharField, OuterRef, Subquery

# 原日期过滤条件
date_filter = Q(start_date__lte=OuterRef('object_start_date'), end_date__gte=OuterRef('object_start_date')) | \
    Q(start_date__lte=OuterRef('object_start_date'), end_date=None)

# 带日期过滤的查询（保留distinct）
filtered_query = Object.objects.filter(date_filter, user=OuterRef('user')).distinct()

# 判断带过滤的查询是否有结果
has_filtered_data = Exists(filtered_query)

# 不带日期过滤的查询（指定排序保证first()的确定性）
unfiltered_query = Object.objects.filter(user=OuterRef('user')).order_by('id')

步骤2：在主查询中动态切换逻辑 #

通过Case-When根据has_filtered_data的结果选择对应的子查询：

main_query = Main.objects.annotate(
    role=Case(
        # 当带过滤的查询有结果时，使用原逻辑
        When(has_filtered_data, then=Subquery(filtered_query.values('role__name')[:1])),
        # 无结果时，使用不带过滤的第一条数据
        default=Subquery(unfiltered_query.values('role__name')[:1]),
        # 指定输出字段类型，避免类型匹配问题
        output_field=CharField()
    )
)

关键说明 #

• 为什么不能用len(data_subquery) == 0：Django的QuerySet是惰性求值的，当作为Subquery使用时，它会被转换成SQL语句在数据库端执行。提前用len()会触发额外查询，且此时OuterRef的关联参数还未绑定，无法得到正确的判断结果。
• 不带过滤的查询必须加order_by：first()的结果依赖数据库返回顺序，不加排序会导致结果不稳定，建议选择业务上有明确顺序的字段（如主键id）。
• 所有逻辑完全在数据库层面完成，不会产生额外的查询开销，符合ORM的最佳实践。

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