Django聚合字段避免N+1问题：关联模型统计优化

完全可以通过Django的查询聚合能力实现，一次性获取所有缴费记录及对应的出勤次数，彻底避免N+1查询问题。

具体实现方式 #

利用Subquery和Count结合，在查询CourseStudentPayment时直接注入统计结果：

首先导入所需模块：

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

然后构造查询：

# 子查询：统计当前缴费记录对应的学生、且出勤日期晚于等于该缴费生效日期的出勤次数
presence_count_subquery = Presence.objects.filter(
    course_student=OuterRef('course_student'),  # 关联外部查询的CourseStudent
    date__gte=OuterRef('start_date')           # 过滤出勤日期>=缴费生效日期
).values('course_student').annotate(
    total=Count('id')
).values('total')

# 查询所有CourseStudentPayment，并通过annotate添加统计字段
payments_with_lessons = CourseStudentPayment.objects.annotate(
    lessons_complete=Subquery(presence_count_subquery, output_field=models.IntegerField())
)

使用方式 #

遍历查询结果时，直接访问对象的lessons_complete字段即可，不会触发额外SQL查询：

for payment in payments_with_lessons:
    print(f"缴费记录ID:{payment.id}，生效后出勤次数:{payment.lessons_complete}")

针对单个CourseStudent的场景 #

如果要获取某个特定学生的所有缴费记录及统计，也可以直接用反向关联查询：

target_student = CourseStudent.objects.get(id=123)
student_payments = target_student.course_student_payments.annotate(
    lessons_complete=Subquery(presence_count_subquery, output_field=models.IntegerField())
)

原理说明 #

这段代码会被Django转换为一条包含子查询的SQL语句，一次性拉取所有缴费记录和对应的统计数据，替代原来遍历每个缴费记录时单独发起的Count查询，从根本上解决N+1问题。

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