annotate 为每个对象附加计算字段并返回 QuerySet，aggregate 将整个 QuerySet 压缩为单个字典结果；前者需配合 values() 实现分组，后者天然无分组。
annotate 和 aggregate 本质区别在哪
不是“单行 vs 整表”这种模糊说法——annotate 是给每个 queryset 对象**附加计算字段**，aggregate 是把整个 queryset **压成一个字典结果**。前者返回 QuerySet（可链式操作），后者直接返回 dict（不可再 filter 或 order_by）。
常见错误现象：qs.annotate(total=Sum('price')).aggregate(Avg('total')) 报错，因为 aggregate 不认 annotate 添加的字段（它只作用于原始模型字段或聚合表达式本身）。
-
annotate必须配合values()才能实现分组：不加values()就是每条记录都算一遍（比如对每条订单算客户总消费，但没按客户分组，结果就全一样） -
aggregate天然无分组，想分组必须换annotate+values() - 性能上，
annotate+values()会触发 GROUP BY；aggregate是 SELECT AGG() FROM table —— 前者可能因分组键多、数据量大而慢得多
values() 放哪？为什么放错就查不到分组效果
values() 必须在 annotate() 之前调用，且要包含所有用于分组的字段。Django 不允许先 annotate 再 values，也不允许 values 中漏掉分组依据字段（否则 SQL GROUP BY 不合法）。
使用场景：统计每个用户的订单数和总金额。
立即学习“Python免费学习笔记（深入）”；
- ✅ 正确：
User.objects.values('id', 'name').annotate(order_count=Count('order'), total=Sum('order__amount')) - ❌ 错误：
User.objects.annotate(...).values('id')—— annotate 在前，values 只能取原始字段，刚加的order_count字段丢了 - ❌ 错误：
User.objects.values('id').annotate(...)—— 缺少name，SQL 会报 “non-aggregated column 'name' not in GROUP BY” - ⚠️ 注意：
values()顺序影响结果排序稳定性（尤其 PostgreSQL），建议显式加order_by()
复杂条件聚合：Case When 怎么嵌进 annotate
Django 的 Case + When 是写条件聚合的核心，但它不能直接当字段名用，必须包在 Sum、Count 等聚合函数里，否则报 FieldError: Cannot resolve keyword 'case' into field。
示例：统计每个用户「已支付订单金额」和「未支付订单金额」两列。
from django.db.models import Case, When, Sum, IntegerField
User.objects.values('id').annotate(
paid_total=Sum(
Case(
When(order__status='paid', then='order__amount'),
output_field=IntegerField()
)
),
unpaid_total=Sum(
Case(
When(order__status='unpaid', then='order__amount'),
output_field=IntegerField()
)
)
)
-
then参数必须是字段路径字符串（如'order__amount'），不能是变量或表达式；想动态拼字段？得用F()+Case组合 -
output_field必须显式指定，否则 Django 推导失败（尤其跨关联表时） - 多个
When之间是“互斥匹配”，没匹配上的默认为 NULL；需要兜底？加default=0到Case
跨多层外键聚合容易漏掉空关系
比如 User → Order → Item → Category，想按 Category 统计用户消费总额。如果某用户没下单，或订单没商品，或商品没分类，那这条记录在 annotate + values() 中直接消失——Django 默认用 INNER JOIN。
解决方法只有改用 LEFT JOIN，即把外键字段声明为 isnull=True 或显式用 select_related/prefetch_related 不起作用，必须靠 annotate 前的 filter 或 exclude 控制连接方式。
- ✅ 补全空关系：
User.objects.annotate(...).filter(order__isnull=False).values(...)不行，这还是过滤掉空用户；正确做法是用Coalesce+LeftJoin模拟，但 Django 不直接支持；更稳的是用OuterRef+ 子查询，或干脆用raw() - ⚠️ 容易踩的坑：
order__item__category__name这种深度路径在values()中出现，若中间某级为空，整行被 DROP —— 没 warning，结果莫名变少 - 调试技巧：打印 SQL：
str(qs.query)，看生成的 JOIN 类型和 WHERE 条件
复杂点从来不在语法，而在你默认假设“有数据”的那个地方——外键为空、反向关系为空、聚合字段为 NULL，这些值不会报错，只会静默消失。
