合并Django QuerySet时，如何保留不同annotate的relevance字段值？

这问题我之前做多维度搜索排序时也踩过一模一样的坑！你遇到的核心问题是Django的QuerySet.__or__（也就是|操作符）在合并两个带有同名注解的QuerySet时，会优先采用第一个QuerySet的注解定义，导致第二个QuerySet的注解被完全覆盖——所以你给words设置的relevance=2会被full_name的relevance=1冲掉，最终所有结果的relevance都是1，排序自然失效。

不用转列表，我们可以在数据库层面直接解决这个问题，下面是两种和你思路一致的可行方案：

方案一：合并后用Case/When动态标记相关性 #

这是最简洁的方案，不用提前给两个QuerySet分别加注解，而是在合并后通过判断对象是否属于full_name集合来设置relevance：

from django.db.models import Case, When, IntegerField

# 先获取原始的两个查询集（不要提前annotate）
full_name = YourModel.objects.filter(name="Michael Scott")
# 可选：排除full_name里的结果，避免重复
words = YourModel.objects.filter(name__in=["Michael", "Scott"]).exclude(pk__in=full_name)

# 合并后统一设置相关性注解并排序
combined_results = (full_name | words).annotate(
    relevance=Case(
        # 属于full_name集合的，relevance设为1
        When(pk__in=full_name, then=1),
        # 其余的（来自words）设为2
        default=2,
        output_field=IntegerField()
    )
).order_by('relevance')

这种方法直接在数据库层面完成判断和排序，保留了QuerySet的惰性求值特性，性能也更优。

方案二：给两个QuerySet加不同名的注解，合并后统一转换 #

如果你坚持要先给两个QuerySet分别标记，也可以给它们的注解起不同的名字，合并后再通过Case/When统一成relevance字段：

from django.db.models import Case, When, IntegerField, Value

full_name = YourModel.objects.filter(name="Michael Scott").annotate(full_rel=Value(1, IntegerField()))
words = YourModel.objects.filter(name__in=["Michael", "Scott"]).annotate(word_rel=Value(2, IntegerField()))

combined_results = (full_name | words).annotate(
    relevance=Case(
        When(full_rel=1, then=1),
        When(word_rel=2, then=2),
        default=2,
        output_field=IntegerField()
    )
).order_by('relevance')

这个方案稍显繁琐，但逻辑和你最初的思路更贴近，也能避免注解被覆盖的问题。

为什么原来的方法会失效？ #

补充个小知识点：Django在合并两个QuerySet时，会将它们的查询语句、注解、过滤条件等合并成一个新的QuerySet。如果两个QuerySet有同名的注解，Django会直接使用第一个QuerySet的注解定义，第二个的会被丢弃——这就是为什么你的words的relevance被改成1的原因。

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