ThinkPHP5聚合查询需注意调用时机、字段合法性与链式顺序：count()须传字段名防重写；max/min/avg/sum需真实数值字段；group不支持函数表达式，须用field定义别名；多聚合值应统一用field()一次查出。
ThinkPHP5 的聚合查询不是“调个方法就行”，直接用 count()、sum() 等方法，稍不注意就会返回 0、1、null 或直接 SQL 报错——问题不在数据，而在调用时机、字段合法性、链式顺序这些细节上。
count() 返回 0 或 1？不是没数据，是 SQL 被重写了
这是最常踩的坑：在用了 join()、group() 或 having() 后还直接调 count()，框架会把它当“是否存在”语义，生成类似 SELECT COUNT(*) FROM (SELECT ...) 的非法子查询。
- ✅ 正确写法：
count('id')或count('user_id')，显式传字段名，避开*触发的默认重写 - ✅ 分页前必须固化条件：先完成所有
where()、join()，再调count()；paginate()内部会自动调一次，动态追加条件会导致两次 count 不一致 - ✅ 查关联表数量优先用
withCount()，它生成的是安全的(SELECT COUNT(*) FROM ...)子句，不会被重写 - ⚠️
count()不带参数时等价于count('*')，但在复杂链式中可能跳过已设的where条件，别依赖它
max()/min()/avg()/sum() 报错或返回 null？字段和 NULL 是关键
除 count() 外，其余四个方法都强制要求传字段名，且该字段必须是数据库里真实存在的数值型列（INT、DECIMAL），不能是表达式、别名或 JSON 路径（低版本不支持）。
- ❌
max('user_id, score')、sum('IFNULL(price, 0)')都非法 —— ThinkPHP 不解析函数表达式，只拼字符串进 SQL - ✅ 有 NULL 值时，
sum('price')和avg('price')会自动忽略，要强制补 0 得改用field('SUM(IFNULL(price, 0)) AS total')->find() - ✅ 字段类型不匹配会静默失败或报错：MySQL 8.0+ 开启
STRICT_TRANS_TABLES时，对VARCHAR字段调sum()直接报错，不是返回 0 - ✅
max()和min()无匹配记录时返回null，不是 0；前端直接 echo 会空白，参与运算可能触发 Notice，建议用(float) $value或?? 0容错
按日期分组统计（如日活、月销量）为什么 group('DATE(create_time)') 总报错？
group() 方法只接受纯字段名或 field() 中定义过的别名，对 DATE()、YEAR() 这类函数表达式不做解析，而是原样加反引号，变成 `DATE(create_time)`，导致 SQL 语法错误。
立即学习“PHP免费学习笔记（深入）”；
- ✅ 安全做法：先用
field()定义别名，再 group 别名$User->field('COUNT(*) as cnt, DATE(create_time) as day')->group('day')->select() - ✅ 更灵活方案：用
Db::query()写原生 SQL，可控性强Db::query("SELECT COUNT(*), DATE(create_time) FROM user GROUP BY DATE(create_time)") - ⚠️ 注意时区：
DATE(create_time)依赖 MySQL 服务端时区，若与 PHP 时区不一致，结果可能偏移一天 - ⚠️ 别名若用 MySQL 关键字（如
order、group），必须加反引号或换名，否则 SQL 报错
一次查多个聚合值（count + sum + avg）怎么写才不查三次库？
分开调 count()、sum()、avg() 就是三次完整查询，性能浪费明显。ThinkPHP 支持单次 SQL 混用多个聚合函数，但必须用 field() + find() 组合，且不能混选普通字段（除非加 group()）。
- ✅ 正确写法：
$model->field('COUNT(*) AS total, SUM(money) AS amount, AVG(score) AS avg_score')->find() - ⚠️ 错误写法：
$model->count() + $model->sum('money') + $model->avg('score')—— 三次独立查询，条件重复执行 - ⚠️ 如果混选普通字段（如
field('name, COUNT(*)')）且没group()，MySQL 会报ERROR 1140，ThinkPHP 不会提前拦截 - ✅ 多指标统计推荐统一用
field()显式声明，返回数组可直接取$res['total']、$res['amount']等
真正容易被忽略的，是字段合法性检查和链式顺序——框架不会帮你校验字段是否存在、是否为数值型、是否被允许用于聚合，这些全靠你写之前确认。一旦出错，往往表现为“查不到数据”或“值不对”，而不是明确报错，排查成本远高于预防成本。
