Django aggregate用法：Sum/Avg/Max聚合查询详解

本文深入解析了 Django 中 `aggregate()` 聚合查询的核心用法与常见陷阱，重点澄清其默认作用于全表而非必须配合 `filter()` 使用，并系统讲解 `Sum`、`Avg`、`Max` 等函数的正确调用方式、空值（`None`）处理策略、多字段一次聚合的高效写法，以及 `aggregate()` 与 `annotate()` 的本质区别——前者返回单条汇总字典，后者结合 `values()` 实现分组统计；同时提醒开发者警惕数据库 NULL 行为差异、字段类型限制、空字符串伪装 NULL 导致的统计偏差，以及时区设置对时间分组的影响，帮助你在真实项目中写出准确、高效、可维护的聚合查询。

直接用 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，还会让数据库重复扫描全表 —— 特别是大表，性能落差明显。

正确写法：

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')
</p>

• values() 在前，决定分组维度；annotate() 在后，决定每组算什么
• 漏掉 values() 会导致结果变成每行一个聚合值（相当于没分组），且可能去重丢失数据
• 时间字段用 TruncMonth、TruncDate 等函数前，确认数据库时区设置和 Django 的 TIME_ZONE 一致，否则分组错位

聚合本身不难，难的是搞清「我要的是单个汇总值」还是「一组分组结果」——选错方法，SQL 就跑偏了。还有就是 null 值和空字符串混用时，统计结果经常和肉眼数的对不上，得单独验证。

以上就是《Django aggregate用法：Sum/Avg/Max聚合查询详解》的详细内容，更多关于的资料请关注golang学习网公众号！