ThinkPHP聚合函数返回NULL是MySQL默认行为，应根据业务语义显式处理：需零值时用IFNULL封装，需区分“无数据”与“数值为零”时保留NULL并明确文档说明。
ThinkPHP 查询中聚合函数返回 NULL 怎么办
直接说结论：ThinkPHP 的 sum()、avg() 等聚合方法在无匹配数据时默认返回 null，不是 0，也不是空字符串——这会导致 PHP 类型判断出错、前端展示异常或 JSON 序列化为 null 字段。
根本原因不是框架 bug，而是 SQL 层面的自然行为：MySQL 聚合函数对空结果集返回 NULL，TP 默认不做干预。
常见错误现象：sum('price') 在查不到记录时返回 null，后续做 $total + 10 得到 10（因为 null + 10 === 10），但换成 intval($total) 就变成 0，行为不一致；更隐蔽的是用在 API 返回里，前端收到 "total": null 却预期是数字。
- 别依赖模型自动转
0—— TP 模型层不处理聚合结果的 NULL 合并 - 别在控制器里写
?: 0就完事 —— 这掩盖了「本应有数据却为空」的业务异常 - 聚合字段若参与计算（如占比、平均单价），必须显式定义空值语义：是「无数据」还是「零值」？
用 IFNULL 原生封装聚合查询
最可控的方式是在查询构建时把 IFNULL 写进字段表达式，让数据库层就补全值，避免 PHP 层反复判断。
立即学习“PHP免费学习笔记（深入）”；
使用场景：需要稳定返回数字类型、且空结果可安全视为 0（比如统计今日订单总额）。
注意点：IFNULL 是 MySQL 函数，SQLite 用 IFNULL 或 COALESCE，PostgreSQL 只认 COALESCE。TP 的 raw() 不做方言适配，跨库需自行处理。
示例（MySQL）：
Db::table('order')->where('create_time', '>=', strtotime('today'))->sum(Db::raw('IFNULL(sum(price), 0)'));
但更推荐写在 field() 里，便于复用和调试：
Db::table('order')
->where('status', 1)
->field('COUNT(*) as cnt, IFNULL(SUM(price), 0) as total')
->find();
-
IFNULL(expr1, expr2)只接受两个参数，第二个不能是字段名（会报错），只能是字面量如0、0.0、'-' - 如果想返回
0.00保持小数位，用IFNULL(SUM(price), 0.00)，别用ROUND(IFNULL(...), 2)—— 多余计算且可能四舍五入失真 - 嵌套聚合慎用：
IFNULL(AVG(IFNULL(score, 0)), 0)看似稳妥，实则改变了统计口径（把缺考当 0 分算进平均）
模型中封装带默认值的聚合方法
在模型里加一个方法，比每次手写 raw() 更安全、可测试、易维护。
关键不是“封装”，而是明确空值语义。比如订单模型里 getTodayTotalAttr() 表示「今天应收总额」，那空值就是 0；但 getAvgUnitPriceAttr() 若用于质量分析，空值可能该抛异常，而不是硬塞 0。
示例（OrderModel.php）：
public function getTodayTotalAttr()
{
return $this->whenWhere('create_time', '>=', strtotime('today'))
->sum($this->getConnection()->raw('IFNULL(SUM(price), 0)'));
}
这样调用 OrderModel::getTodayTotalAttr() 就始终是整数，且逻辑收口在模型内。
- 别在
getAttr方法里做复杂查询 —— 它本意是获取已查出字段的加工值，不是发起新查询 - 如果该聚合要支持条件链式调用（如
->where('type', 2)->todayTotal()），就做成普通方法todayTotal($default = 0)，而非获取器 - TP6 的
withSum不支持IFNULL，它底层走的是纯字段聚合，遇到空仍是null，别误用
NULL 和 0 在业务语义上的混淆风险
最常被忽略的不是技术实现，而是把「没数据」等同于「数值为零」。
比如统计「每个用户最近一笔订单金额」，用 MAX(id) 关联子查询，若某用户从未下单，结果是 null；但如果用 IFNULL 强制变 0，前端就会显示「该用户最新订单：¥0.00」——这明显是错误信息。
此时正确做法是：保留 null，并在 API 层明确标注字段含义，例如返回 "last_order_amount": null 并配文档说明「null 表示无历史订单」。
- 财务类字段（如应付/实付）严禁用
IFNULL静默转0，必须区分「未发生」和「发生但为零」 - 前端展示时，
null渲染成「-」或「暂无」比渲染成0更诚实 - 聚合结果进缓存前，先确认是否允许空值落库 —— Redis 存
null很容易被当成连接失败或序列化错误
空值不是异常，是有效状态。处理它的前提，是先问清楚：这个 NULL，到底代表什么。
