在Django中如何对多对多（M2M）字段执行annotate注解操作？

我定义了以下Django模型：

class Convocacao(models.Model):
    cursos = models.ManyToManyField(Curso)

class RegistroConvocacao(models.Model):
    aluno = models.ForeignKey(Aluno)
    convocacao = models.ForeignKey(Convocacao)
    tipo = models.IntegerField(choices=TiposConvocacao)

class Aluno(models.Model):
    curso = models.ForeignKey(Curso)

获取指定Convocacao对象后：

obj = get_object_or_404(Convocacao, pk=pk)

尝试给obj.cursos添加annotate统计符合条件的RegistroConvocacao数量时，出现TypeError: 'ManyRelatedManager' object is not iterable错误，原代码如下：

cursos = obj.cursos.all()
cursos = cursos.annotate(       
    total_ingressantes=obj.registroconvocacao_set.filter(
            aluno__curso__in=obj.cursos, 
            tipo_convocacao=RegistroConvocacao.TIPO_CONVOCACAO_INGRESSANTE
    ).count()
)

需求是遍历每个curso时能直接获取total_ingressantes：

for curso in obj.cursos.all():
    total = curso.total_ingressantes
    ...

错误原因 #

原代码的核心问题有两个：

1. annotate中直接调用count()会返回一个固定数值，无法为每个Curso实例动态计算对应统计量；
2. aluno__curso__in=obj.cursos里的obj.cursos是ManyRelatedManager对象，需转为可迭代的查询集（obj.cursos.all()），但更关键的是没有关联到当前被annotate的Curso实例。

解决方案 #

方法一：使用Count结合过滤参数

利用Django的Count聚合函数，通过filter参数绑定当前Curso和目标Convocacao对象的关联条件：

from django.db.models import Count, Q

cursos = obj.cursos.annotate(
    total_ingressantes=Count(
        'aluno__registroconvocacao',
        filter=Q(
            aluno__registroconvocacao__convocacao=obj,
            aluno__registroconvocacao__tipo=RegistroConvocacao.TIPO_CONVOCACAO_INGRESSANTE
        ),
        distinct=True  # 避免重复统计同一RegistroConvocacao记录
    )
)

方法二：使用Subquery和OuterRef

通过子查询精准匹配每个Curso对应的统计数量，适合复杂场景：

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

# 构造子查询：统计当前Curso下符合条件的RegistroConvocacao数量
subquery = RegistroConvocacao.objects.filter(
    convocacao=obj,
    tipo=RegistroConvocacao.TIPO_CONVOCACAO_INGRESSANTE,
    aluno__curso=OuterRef('pk')
).values('aluno__curso').annotate(count=Count('pk')).values('count')

# 为每个Curso添加统计字段
cursos = obj.cursos.annotate(
    total_ingressantes=Subquery(subquery, output_field=models.IntegerField())
)

使用方式 #

直接遍历处理后的cursos查询集即可：

for curso in cursos:
    # 示例：打印课程名称和对应的统计数量
    print(f"课程：{curso.nome}，入学人数：{curso.total_ingressantes}")

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