Django中多对多字段按首个关联对象优先的查询实现

要实现“先返回首个关联对象满足条件的Practitioner，再返回其他关联对象满足条件的实例”，核心是先明确“首个关联对象”的定义（多对多关系默认无序，必须指定排序规则），再通过标注排序字段实现优先级。

步骤1：定义“首个关联对象”的排序规则 #

多对多关系本身没有默认顺序，你需要先确定“首个”的判定标准：

• 按关联对象（Practice）的字段排序：比如按id升序、created_at时间最早等。
• 通过through模型维护顺序：如果多对多是自定义中间表（带position字段标记顺序），直接取position=0的关联对象。

步骤2：代码实现（按Practice id升序判定首个） #

from django.db.models import Subquery, OuterRef, Case, When, BooleanField

# 子查询：获取每个Practitioner的第一个Practice（按id升序）的城市slug
first_practice_city = Practice.objects.filter(
    practitioner=OuterRef('pk')
).order_by('id').values('city__slug')[:1]

# 1. 标注每个Practitioner的首个关联是否满足条件
# 2. 筛选出至少有一个关联满足条件的实例
# 3. 按首个匹配标记降序排序，匹配的排前面
# 4. 去重（多对多查询会生成重复实例）
queryset = Practitioner.objects.annotate(
    first_match=Case(
        When(first_practice_city='toronto', then=True),
        default=False,
        output_field=BooleanField()
    )
).filter(
    practices__city__slug='toronto'
).order_by(
    '-first_match'
).distinct()

步骤3：如果用through模型维护顺序（带position字段） #

假设中间表PractitionerPractice有position字段（0为首个关联），代码调整为：

from django.db.models import Subquery, OuterRef, Case, When, BooleanField

# 直接取position=0的关联Practice的城市slug
first_practice_city = PractitionerPractice.objects.filter(
    practitioner=OuterRef('pk'),
    position=0
).values('practice__city__slug')[:1]

queryset = Practitioner.objects.annotate(
    first_match=Case(
        When(first_practice_city='toronto', then=True),
        default=False,
        output_field=BooleanField()
    )
).filter(
    practices__city__slug='toronto'
).order_by(
    '-first_match'
).distinct()

关键注意事项 #

• 必须明确“首个关联”的排序规则，否则查询逻辑无意义。
• distinct()不可省略：多对多关联查询会为每个满足条件的关联生成重复的Practitioner实例，去重后才能得到唯一的实例列表。
• 确保Django版本支持Subquery（Django 1.11及以上版本都支持）。

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