aggregate()默认聚合全表数据，无需filter()；支持多字段一次计算，返回单字典结果；空值返回None需手动处理；分组聚合须用values()+annotate()。
直接用 aggregate() 就能查全表聚合，不用写 filter()
很多人以为 aggregate() 必须配合 filter() 用，其实它默认作用于整个 QuerySet —— 也就是整张表。只要没调用 filter() 或 exclude()，aggregate() 就自动扫全量数据。
常见错误现象：aggregate() 返回空字典或 None，其实是模型里字段为空、类型不匹配，或者误加了无效的 filter() 条件把数据筛没了。
-
Sum、Avg、Max等函数必须传字段名字符串，比如'price'，不能传model.price或变量名 - 对空 QuerySet 调用
Avg或Sum会返回None，不是 0；需要手动处理（如用Coalesce） - 字段类型要支持聚合：文本字段不能用
Avg，布尔字段慎用Sum（Django 会转成 0/1 计数）
Sum 和 Avg 对 null 值默认忽略，但要注意数据库行为差异
PostgreSQL 和 SQLite 都会跳过 NULL 值计算 Sum/Avg，MySQL 默认也如此，但如果你开了 sql_mode=STRICT_TRANS_TABLES 或用了某些旧版本，可能报错。更隐蔽的问题是：字段定义为 blank=True, null=True，但业务写入时用了空字符串或 0 代替 NULL，导致统计失真。
- 检查字段是否真为
NULL：用MyModel.objects.filter(price__isnull=True).count() - 想把空字符串也当
NULL处理？得先用Case+When清洗，不能靠聚合函数自动识别 -
Avg结果是float，但 PostgreSQL 可能返回decimal，取决于字段类型；如果后续要 JSON 序列化，注意decimal需手动转float
多个聚合同时查，别重复调用 aggregate()
一次 aggregate() 调用就能算多个值，反复调用不仅多发 SQL，还会让数据库重复扫描全表 —— 特别是大表，性能落差明显。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
正确写法：
from django.db.models import Sum, Avg, Max
result = MyModel.objects.aggregate(
total=Sum('price'),
avg_price=Avg('price'),
highest=Max('price')
)
# → {'total': 1250.0, 'avg_price': 125.0, 'highest': 320}
- 每个参数名（如
total）就是结果字典的 key，可自定义，不必和函数同名 - 如果某个字段全为
NULL，对应 key 的值是None，不会报错 - 不要写成
aggregate(Sum('x')).update(aggregate(Avg('y')))—— 这是两次查询，还覆盖了前一个结果
想按日期分组再聚合？那得用 values() + annotate()，不是 aggregate()
aggregate() 只返回单个字典，没法分组；一看到“每天销量总和”“每月平均价格”，就得切到 annotate() 路线。
例如按年月分组求和：
from django.db.models import Sum
from django.db.models.functions import TruncMonth
<p>MyModel.objects.annotate(
month=TruncMonth('created_at')
).values('month').annotate(
total=Sum('price')
).order_by('month')
-
values()在前，决定分组维度；annotate()在后，决定每组算什么 - 漏掉
values()会导致结果变成每行一个聚合值（相当于没分组），且可能去重丢失数据 - 时间字段用
TruncMonth、TruncDate等函数前，确认数据库时区设置和 Django 的TIME_ZONE一致，否则分组错位
聚合本身不难，难的是搞清「我要的是单个汇总值」还是「一组分组结果」——选错方法，SQL 就跑偏了。还有就是 null 值和空字符串混用时，统计结果经常和肉眼数的对不上，得单独验证。
