ThinkPHP聚合函数常见误用：count()在join/group后返回0或1，因框架重写为非法子查询；sum()/avg()报错因传入空数组或非数值字段；max()/min()无结果时返回null而非0；别名需符合MySQL规范且避免关键字。
count() 返回 0 或 1 而不是真实总数？
这是 ThinkPHP 最常被误用的点：直接调用 count() 在 join、group 或 having 后，会触发内部重写为非法子查询，导致返回 0 或 1。不是数据库没数据，是 SQL 构造错了。
根本原因是框架在复杂查询链中默认把 count() 当作“是否存在”的布尔判断处理，尤其在模型关联或分页前未固化条件时更明显。
- 显式指定字段：
count('id')或count('user_id')，避免空值干扰 - 用
field()+find()替代多次单查，比如field('count(id) as total, sum(amount) as total_amount') - 如果必须分页+统计，先用
where()固定筛选条件，再调count()，别在join()后直接跟count()
sum() 和 avg() 报错 “Invalid argument supplied for foreach()”？
这不是聚合函数本身的问题，而是你传了空数组或非数值字段给 sum()/avg()，而框架底层尝试遍历结果时崩溃。常见于 JSON 字段未开启支持、或字段类型为 text/varchar 却强行求和。
ThinkPHP 5.1.5+ 才支持对 JSON 字段做聚合，低版本直接调 sum('extra->price') 必报错。
立即学习“PHP免费学习笔记（深入）”；
- 确认字段类型是数值型（
INT、DECIMAL），不是VARCHAR存数字字符串 - 若字段是 JSON 类型且版本 ≥5.1.5，需配合
json_unquote(json_extract(...))写法，或改用原生query() - 加兜底判断：
$amount = Db::name('order')->sum('amount') ?: 0;，避免空结果参与后续运算
max() / min() 返回 null 而不是 0？
max() 和 min() 在无匹配记录时返回 null，不是 0 —— 这和 count()/sum() 的默认行为不一致，容易引发 PHP Notice 或逻辑断裂。
尤其在前端展示平均值、最高分等场景，null 直接 echo 会输出空白，但参与计算可能触发类型错误。
- 强制转换：
(float) Db::name('product')->max('price') - 用 coalesce 包裹（需原生）：
Db::query("SELECT COALESCE(MAX(price), 0) FROM think_product WHERE status=1") - 第二参数控制类型转换：
max('price', false)表示不自动转 float，适合需要保持原始字符串精度的场景
聚合结果要带别名却生成了无效 SQL？
直接写 field('count(id) as total') 是安全的，但若混用 alias() 或在 join() 后用 field('COUNT(*)')，部分版本会忽略别名或拼错括号位置。
最稳妥的方式是只用 field() 显式声明全部聚合字段，并确保所有别名符合 MySQL 标识符规范（不能含空格、保留字）。
- 正确：
field('count(id) as total_count, sum(amount) as total_amount') - 错误：
field('count(*) as total count')（空格导致语法错误） - 别名含下划线或小写字母没问题，但避免用
order、group等关键字
delete_time IS NULL）会静默过滤掉本该参与统计的数据。查不到数，往往不是 sum() 写错了，是 withTrashed() 没开，或者 whereTime() 把时间范围卡死了。 
