跨表聚合需预加载关联数据并正确处理分组与空值：用select_related/prefetch_related优化n+1，annotate中聚合字段名须准确，values分组字段须完整，多对多count需distinct=true，空值用filter或case处理。
跨表聚合时忘记加 select_related 或 prefetch_related 导致 N+1 查询
直接在 annotate() 中引用外键字段（比如 author__name）不会自动触发 JOIN，Django 会为每个主表对象单独查一次关联表。结果是页面加载慢、数据库连接数飙升，甚至超时。
正确做法是先用 select_related（一对一/多对一）或 prefetch_related（一对多/多对多）预加载关联数据，再做聚合。注意：它们只影响查询时的 SQL JOIN 方式，不影响 annotate() 的逻辑。
-
select_related('author')生成 LEFT OUTER JOIN，适合单值关联（如Post.author） -
prefetch_related('tags')发起额外 SELECT，适合集合关联（如Post.tags.all()），不能用于annotate()中的聚合字段 - 如果聚合本身需要 JOIN（如统计每个作者发帖数），应直接在
annotate()中用Count('post_set')，而非依赖prefetch_related
用 annotate() + Count() 实现分组计数但结果为空
常见原因是关联字段名写错，或者没处理空值。Django 默认忽略 NULL 关联，比如某条 Post 的 category_id 是 NULL，它就不会出现在 values('category__name').annotate(count=Count('id')) 结果里。
解决方法是显式控制空值行为：
- 加
filter(category__isnull=False)排除空关联 - 用
Count('category', distinct=True)避免因多对多导致重复计数 - 若想保留空分类，改用
Case+When构造默认分组，例如：annotate(category_name=Case(When(category__isnull=True, then=Value('Uncategorized')), default=F('category__name')))
在 values() 分组中混用非分组字段引发 FieldError
Django 要求 values() 后的字段必须全部出现在 GROUP BY 子句中，否则报错：FieldError: Cannot resolve keyword 'created_at' into field.
典型错误写法：Post.objects.values('author__name').annotate(total=Count('id')).order_by('-created_at') —— created_at 没出现在 values() 里，却试图排序。
- 要么把
created_at加进values()（变成按作者+时间分组） - 要么改用聚合函数排序，例如
order_by('-max_created')，并提前annotate(max_created=Max('created_at')) - 注意 SQLite 对
GROUP BY更严格，PostgreSQL 允许部分字段省略（但 Django ORM 层仍会校验）
多对多关系下 Count 统计失真
一个 Post 有多个 Tag，执行 values('tag__name').annotate(post_count=Count('id')) 会把同一篇文章在不同 tag 下重复计数。比如一篇带 3 个 tag 的文章，会在结果里贡献 3 次。
真正想统计“每个 tag 下有多少篇文章”，必须加 distinct=True：
-
Count('post_set', distinct=True)（反向关系） - 或
Count('id', distinct=True)（正向，但需确保values()分组粒度正确） - 更安全的方式是换角度：从
Tag.objects.annotate(post_count=Count('post'))开始，避免中间表干扰
跨表聚合真正难的不是语法，而是搞清数据模型里“谁属于谁”、以及 SQL 层面到底要 JOIN 还是 SUBQUERY。写完记得用 queryset.query 看生成的 SQL，比猜可靠得多。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
