当前位置：首页 > 文章列表 > 文章 > python教程 > Django aggregate用法：Sum/Avg/Max聚合查询详解

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

2026-05-26 16:09:17 0浏览收藏

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

Django aggregate怎么用_Sum/Avg/Max聚合查询所有数据

直接用 `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
MyModel.objects.annotate(
month=TruncMonth('created_at')
).values('month').annotate(
total=Sum('price')
).order_by('month')