ThinkPHP模型group()不支持直接在group()中写DATE(create_time)等日期函数，因框架会自动加反引号导致SQL非法；正确做法是先在field()中用别名定义日期字段（如DATE(create_time) as day），再group('day')。
ThinkPHP模型group()不支持日期函数表达式分组
直接在 group() 里写 group('DATE(create_time)') 或 group('YEAR(create_time)') 会报错或分组失效，因为 ThinkPHP 默认把参数当字段名处理，自动加反引号，最终生成类似 GROUP BY `DATE(create_time)` 的非法 SQL。
正确做法是把日期计算提前到 field() 中定义别名，再用别名分组：
-
field('DATE(create_time) as day, count(*) as total')→ 然后group('day') - 若需按月：用
field('DATE_FORMAT(create_time, "%Y-%m") as month, ...')+group('month') - 复杂时间逻辑（如上个月、近7天）建议改用
Db::query()原生查询，避免框架转义干扰
count() 在 join/group 后返回 0 或 1 而不是真实总数
这不是数据问题，是 ThinkPHP 在遇到 join() 或 group() 后，内部把 count() 重写成子查询（类似 SELECT COUNT(*) FROM (SELECT ...) AS tp_count），而该子查询没带 GROUP BY 或字段别名，导致 MySQL 返回单行布尔值。
安全写法只有两种：
立即学习“PHP免费学习笔记（深入）”；
- 先固化条件：用
where()锁定筛选范围，再调count('id')（显式指定字段，避免COUNT(*)触发重写） - 绕过模型链式调用：直接
Db::name('user')->field('COUNT(*) as total')->join(...)->group(...)->find()['total'] - 分页场景下，绝对不要在
join()后直接跟count()；应先select()得到 ID 列表，再用count()查主表原始总数
sum()/avg() 报 “Invalid argument supplied for foreach()”
错误不在聚合函数本身，而是框架底层尝试遍历查询结果时传入了空数组或非数值字段。常见于：
- 字段类型是
VARCHAR却存数字字符串（如'123.45'），MySQL 不报错但 PHP 遍历时崩溃 - 低版本 ThinkPHP（extra->price）调
sum()直接失败 - 关联查询后未限制字段，
sum('order.amount')实际被解析成sum('amount')，但结果集里没有该字段
排查优先级：dump(Db::name('table')->field('amount')->where(...)->select()) 看字段是否存在、是否为空、是否为数值类型。
max()/min() 返回 null 导致前端空白或 PHP Notice
无匹配记录时，max() 和 min() 返回 null，而 count() 返回 0、sum() 返回 0，行为不一致，容易漏判。
生产环境必须兜底：
- 简单转换：
(float) Db::name('product')->max('price')，null变成0.0 - 数据库层兜底：用原生
Db::query("SELECT COALESCE(MAX(price), 0) FROM think_product WHERE status=1") - 注意
max('price', false)这种写法只是禁用自动类型转换，不会改变null返回值
最易忽略的是：前端模板里直接 {$max_price}，null 渲染为空白，但业务逻辑可能依赖它参与比较或运算——这里必须显式判断或转换。
