aggregate() 返回单字典且终结查询链，必须置于末尾；annotate() 需配合 values() 实现 GROUP BY，顺序不可颠倒；二者是 Django ORM 聚合唯二入口，绕开即放弃安全与可维护性。
aggregate() 和 annotate() 是 Django ORM 对 MySQL 聚合统计的唯二入口，别想绕开它们用原生 SQL 拼接——除非你明确放弃 ORM 的安全性和可维护性。
aggregate() 返回单个字典，不是 QuerySet
它一执行就终结查询链，后续不能再接 filter()、order_by() 或另一个 aggregate()。常见错误是写成：
Book.objects.filter(in_stock=True).aggregate(Avg('price')).filter(...)这会报 AttributeError: 'dict' object has no attribute 'filter'。
-
aggregate()必须放在链末尾，且只接受聚合函数（如Avg('price')），不接受字段名或条件 - 键名默认为
field__func（如'price__avg'），想自定义就显式起别名：avg_price=Avg('price') - 多个聚合可一次传入：
Book.objects.aggregate(total=Count('id'), avg=Avg('price')) - 空 QuerySet 时返回
None（如Count为 0，Avg/Sum为None），记得判空
annotate() 必须配合 values() 才等价于 GROUP BY
MySQL 的 GROUP BY 在 Django 中不是靠 annotate() 单独实现的，而是靠 values() 声明分组字段 —— 它决定 GROUP BY 的列，annotate() 只负责每组内的计算。
立即学习“Python免费学习笔记（深入）”；
错例：Book.objects.annotate(avg_price=Avg('price')) → 实际执行的是对每条记录单独算平均值（无意义），不是按作者/出版社分组。
- 正确写法：
Book.objects.values('author').annotate(count=Count('id'), avg_price=Avg('price'))→ 对应GROUP BY author -
values()必须在annotate()前，顺序不能颠倒；否则分组逻辑失效 - 跨表分组（如按出版社名）要用双下划线：
values('publisher__name')，但注意该字段必须在values()中显式列出 - 如果只想要聚合结果不关心原始字段，用
.values('author').annotate(...).values('count', 'avg_price')
MySQL 特定行为影响聚合结果
Django 不会帮你屏蔽底层数据库的差异。MySQL 默认开启 sql_mode=STRICT_TRANS_TABLES 时，AVG() 遇到全 NULL 列会返回 NULL，而某些旧版本 MySQL 可能返回 0 —— Django 一律按数据库实际返回值处理。
-
DecimalField字段聚合后仍为Decimal类型，不是 float；打印时容易误以为是字符串 -
Count()对非主键字段计数（如Count('author')）会忽略 NULL 值，等价于COUNT(author)，不是COUNT(*) - 日期字段用
Max('publish_date')没问题，但Min('publish_date')在 MySQL 5.7+ 下可能因时区配置返回意外结果，建议统一用 UTC 存储 - 聚合中混用
F()表达式（如ExpressionWrapper(F('price') * F('discount'), output_field=FloatField())）需显式指定output_field，否则 MySQL 可能报类型不匹配
性能陷阱：不要在循环里调用 aggregate()
比如遍历作者列表，对每个作者查一次 Book.objects.filter(author=a).aggregate(Avg('price')) —— 这会触发 N+1 查询，100 个作者就是 101 次 MySQL 请求。
正确做法是单次分组：Author.objects.annotate(avg_book_price=Avg('book__price'))，依赖反向关系自动 JOIN。
- 确保外键字段有数据库索引（如
book.author_id），否则annotate()分组可能全表扫描 - 大表分组前先用
filter()缩小范围：Book.objects.filter(publish_date__year__gte=2020).values('author').annotate(...) -
annotate()结果默认带主键，如果只取聚合值，加.values('author', 'avg_price')可减少传输数据量
Django 的聚合本质是把 Python 调用翻译成标准 SQL，关键在于理解 aggregate() 和 annotate() 对应的 SQL 语义边界 —— 前者是 SELECT AVG(...) FROM table，后者是 SELECT ..., AVG(...) FROM table GROUP BY ...。漏掉 values() 或错放位置，生成的 SQL 就不是你想要的 GROUP BY。
