ThinkPHP数据统计核心是优先用数据库聚合函数而非PHP循环，count()/sum()/avg()等生成SQL语句，支持连贯操作；GROUP BY需配合field()显式声明字段及别名；返回JSON需规范格式、统一字段名、处理空数据和时间格式；大数据量应优化SQL、精简字段、加缓存或改异步定时任务。
ThinkPHP 做数据统计报表，核心不是“写一堆 PHP 循环”，而是优先用数据库聚合函数完成计算，再由框架封装成可读、可复用的查询链。直接在 PHP 层遍历全表求和或分组，90% 的场景下属于性能浪费。
count() / sum() / avg() 等聚合方法怎么用才不翻车
ThinkPHP 的 count()、sum()、avg()、max()、min() 都是直接生成 SQL 聚合语句，不是 PHP 层计算。但新手常误以为传字段名是“选哪个字段来数”，其实它影响的是 SQL 中的 COUNT 表达式：
-
Db::name('user')->count()→SELECT COUNT(*) FROM user -
Db::name('user')->count('id')→SELECT COUNT(id) FROM user（会跳过 id 为 NULL 的行） -
Db::name('order')->sum('amount')→SELECT SUM(amount) FROM order - 所有方法都支持连贯操作，比如
where()、whereTime()、whereIn()，条件会自动拼进 WHERE 子句 - TP6 中返回值默认是 int/float，不会是字符串；但如果字段本身是字符串类型（如金额存为 VARCHAR），
sum()可能返回 0 或科学计数法，务必确认字段类型是数值型
GROUP BY 统计必须手写原生 SQL 吗
不需要。ThinkPHP 支持原生 GROUP BY，且能和聚合方法共存，但要注意调用顺序和字段别名：
Db::name('order')->field('status, count(*) as total, sum(amount) as amount_total')->group('status')->select()-
field()必须显式写出所有要查的字段，包括分组字段和聚合字段；别名要用as，不能省略 - TP5.1+ 和 TP6 都支持，但 TP5.1 中若用模型调用，需确保模型没有设置
autoWriteTimestamp干扰字段映射 - 如果分组字段含中文或特殊字符（如
category_name），建议加反引号：field('`category_name`, count(*) as total')，避免 SQL 解析失败 - 不要在
group()后接count()——那会变成统计分组数，而不是每个分组的记录数；要每个分组的总数，必须用select()+field
统计接口给 ECharts 用，JSON 格式容易出什么错
后端吐 JSON 给前端图表库，看似简单，实际 70% 的报错来自三类低级但隐蔽的问题：
立即学习“PHP免费学习笔记（深入）”；
- 控制器没用
return json()（TP6）或return $this->success()（TP5.1），而是用了echo json_encode()+exit，导致 Content-Type 是 text/html，前端 fetch 拿到的是解析失败的 Promise - 数据字段名前后端不一致：后端返回
['xAxis' => [...], 'series' => [...]]，前端 JS 却写成data.categories或data.dataList，白屏无报错 - 时间类分组字段（如月份）没做字符串化：
date('Y-m', strtotime($row['created_at']))漏了，结果传过去是时间戳数字，ECharts xAxis 渲染异常 - 空数据没兜底：
select()返回空数组时，array_column($data, 'month')会警告，建议加!empty($data)判断再取列
大数据量统计卡顿或超时怎么办
不是加 set_time_limit(0) 就完事。真正有效的做法是分层拦截：
- 先看 SQL 执行计划：用
Db::name('log')->where(...)->fetchSql(true)->select()拿到原生 SQL，在 MySQL 客户端执行EXPLAIN，确认是否命中索引 - 避免 SELECT *：统计时只查必要字段，尤其是大文本字段（如 content、remark）会拖慢 COUNT
- 对高频统计项（如“今日订单数”）加缓存：
Cache::remember('today_order_count', 300, function () { return Db::name('order')->whereTime('create_time', 'today')->count(); }); - 真要跑全量聚合（如年度销售汇总），改用定时任务 + 结果表：每天凌晨把统计结果写入
stat_yearly_sales表，接口只查这张轻量表
聚合查询本身不难，难的是意识到哪些该丢给数据库做、哪些该缓存、哪些该拆成异步任务。别让一个 count() 成为首页加载的瓶颈点。
