thinkphp 8.0 聚合查询需严格遵循字段显式、顺序固化、分组配field等规则：count()须传字段名防重写，max/min/avg/sum必须数值型字段，group必须配合field声明聚合，多指标应单次field混用，避免性能浪费与语法错误。
ThinkPHP 8.0 的聚合查询不是“调用函数就能出数”，它本质是生成 SQL 的快捷封装，字段传参错、链式顺序乱、分组没配 field，立刻返回 0、1、null 或直接报错——尤其在 join、group、withCount 混用时。
count() 返回 0 或 1？不是没数据，是 SQL 被重写了
这是 TP8 最高频翻车点：在 join()、group()、having() 后直接调 count()，框架会把它当“是否存在”语义，强行套一层子查询，生成类似 SELECT COUNT(*) FROM (SELECT * FROM ...) 的非法结构。
- ✅ 正确写法：
count('id')或count('user_id')，显式指定字段，避开*触发的默认重写 - ✅ 分页前固化条件：先完成
where()、join()，再调count()；别在paginate()前动态追加条件 - ✅ 查关联表数量优先用
withCount()，它生成的是安全的(SELECT COUNT(*) FROM ...)子句，不依赖主查询结构 - ⚠️
count()不带参数时等价于count(*)，但在复杂链式中可能跳过 where 条件，务必验证生成 SQL（可用fetchSql(true)）
max()/min()/avg()/sum() 必须传字段名，且字段必须是数值型
max()、min()、avg()、sum() 全部强制要求传真实字段名，漏写、传错、传表达式都会报错或返回 null。更关键的是，它们对字段类型敏感——MySQL 8.0+ 开启 STRICT_TRANS_TABLES 时，对 VARCHAR 字段求和直接报错，不是静默失败。
- ✅ 确认字段类型是
INT、DECIMAL等数值型，不是字符串存数字（如'123.45'） - ✅ NULL 值会被自动忽略：
sum('price')不统计 NULL 行；要强制转 0，得用field('SUM(IFNULL(price, 0)) AS total') - ✅ JSON 字段聚合需版本 ≥8.0 且字段定义为
JSON类型，低版本或类型不匹配必崩，改用Db::query() - ⚠️
max('score')合法，max('user_id, score')或max('DATE(create_time)')都非法
group() 不是聚合，必须配 field() 写 COUNT/SUM 才有效
group('status') 只加 GROUP BY status，不自动加 COUNT(*)。MySQL 5.7+ 默认开启 only_full_group_by，没显式聚合就直接报错：“Expression #1 of SELECT list is not in GROUP BY clause”。
- ✅ 正确组合：
field('status, COUNT(*) as count, SUM(amount) as total')+group('status') - ✅ 函数名必须大写：
COUNT(*)、SUM(price)，小写在部分版本解析失败 - ✅ 别名建议加上：
as count，否则数组键可能是COUNT(*)这种不可读字符串 - ⚠️
group('DATE(create_time)')会失效——TP8 对 group 参数做字段白名单校验，DATE()被当非法标识符转义成`DATE(create_time)`，语法错误。应改用field('DATE(create_time) as day')+group('day')
多个聚合指标一起查，别分开调三次
分开调 count()、sum()、avg() 是三次全表扫描，性能浪费。TP8 支持单次查询混用多个聚合函数，但必须用 field() 显式声明，且不能混选普通字段（除非加 group()）。
- ✅ 单次获取总数+总金额+平均分：
$model->field('COUNT(*) AS total, SUM(money) AS amount, AVG(score) AS avg_score')->find() - ✅ 多指标+分组：
field('category_id, COUNT(*) as cnt, SUM(price) as total')+group('category_id') - ⚠️
field('id, COUNT(*)')不加group()会触发 MySQL 报错 ERROR 1140，TP8 不提前拦截 - ⚠️ 关联模型里不能直接
hasWhere()->group()，得拆成子查询或两步：先聚合查出映射，再注入到主表结果
最易被忽略的是：所有聚合方法返回标量（整数、浮点、null），但很多人拿 find() 或 select() 的返回值类型去套用，导致取值逻辑错位；还有就是时区问题——DATE(create_time) 依赖 MySQL 服务端时区，和 PHP 时区不一致时，按天分组结果可能偏移一天。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
