为何Django的annotate操作后QuerySet结果异常？

你碰到的情况并非是对annotate的核心理解错误，而是annotate结合外键关联字段时的隐性JOIN操作导致的意外合并。当你在annotate里用F("driver__surname")这类外键关联字段时，Django会自动执行Car表和Person表的JOIN查询。如果你的10条Car记录全关联同一个Person，数据库的分组逻辑（或Django的查询生成逻辑）会把相同driver_name的结果合并，最终只返回1条记录。

两种可靠的解决方式 #

方式1：用模型属性（简单直观） #

直接在Car模型里加个属性方法，不用修改管理器：

class Car(models.Model):
    driver = models.ForeignKey(Person, on_delete=models.PROTECT)
    
    class Meta:
        managed = False
        db_table = "cars"
    
    @property
    def driver_name(self):
        return f"{self.driver.surname}, {self.driver.name}"

担心出现N+1查询的话，查询时带上select_related即可：

Car.objects.select_related('driver').all()

方式2：修正annotate用法（避免合并） #

要是坚持使用annotate，可以显式按Car的主键去重，确保每条记录都被保留：

class CarManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().annotate(
            driver_name=models.ExpressionWrapper(
                models.F("driver__surname") + ", " + models.F("driver__name"),
                output_field=models.TextField()
            )
        ).distinct('id')

或者用子查询替代JOIN，从根源避免合并问题：

from django.db.models import Subquery, OuterRef

class CarManager(models.Manager):
    def get_queryset(self):
        # 子查询获取单个driver的全名
        driver_name_subquery = Person.objects.filter(
            id=OuterRef('driver_id')
        ).annotate(
            full_name=models.F('surname') + ', ' + models.F('name')
        ).values('full_name')[:1]
        
        return super().get_queryset().annotate(
            driver_name=Subquery(driver_name_subquery, output_field=models.TextField())
        )

补充说明 #

annotate的核心作用确实是给查询集里的每个对象添加注解字段，但涉及关联表JOIN时，多条主表记录关联同一条从表记录的情况下，数据库或Django的查询逻辑可能会意外合并结果。通过显式指定去重，或者用模型属性+select_related，能更稳定地实现需求。

内容的提问来源于stack exchange，提问作者Jakub-Wilk