Hyperf中调用MySQL聚合函数需注意ONLY_FULL_GROUP_BY约束、NULL处理及分组排序；正确写法包括sum()直接调用、selectRaw配合CASE WHEN、groupBy显式声明、COALESCE防NULL、orderBy保障顺序，复杂场景建议原生SQL。
Hyperf 中调用 MySQL 聚合函数（如 SUM、COUNT、AVG）做统计，本质仍是执行标准 SQL，但需注意框架层的写法约束和常见陷阱。直接用 QueryBuilder 或原生 SQL 都可行，关键在字段别名、NULL 处理、分组逻辑是否与 MySQL 行为一致。
Hyperf QueryBuilder 中正确使用 SUM/COUNT 等聚合函数
Hyperf 的 Db::table() 或模型查询构造器支持聚合函数，但不能混用普通字段和聚合字段而不加 GROUP BY——这会触发 MySQL 5.7+ 的 ONLY_FULL_GROUP_BY 错误。
- 基础求和：直接写
Db::table('orders')->sum('amount')，返回标量值（PHPfloat或null） - 带条件求和：用
selectRaw配合SUM(CASE WHEN ...)，例如Db::table('orders')->selectRaw('SUM(CASE WHEN status = ? THEN amount ELSE 0 END) as paid_amount', ['paid'])->first() - 分组统计：必须显式调用
groupBy()，且SELECT中所有非聚合字段都得出现在groupBy列表里，例如Db::table('orders')->select('user_id', \DB::raw('SUM(amount) as total'))->groupBy('user_id')->get()
聚合结果为 NULL 时 PHP 层容易忽略的细节
MySQL 的 SUM、AVG 在无匹配行时返回 NULL，Hyperf 不会自动转成 0。如果业务逻辑依赖“0 元”语义，必须手动处理。
-
Db::table('orders')->where('status', 'fake')->sum('amount')返回null，不是0 - 安全写法：用
?? 0或coalesce，例如Db::table('orders')->selectRaw('COALESCE(SUM(amount), 0) as total')->value('total') - 注意
count(*)永远不会是null，但count(amount)在整列全为NULL时返回0，行为符合预期
GROUP BY 多字段时 ORDER BY 必须显式声明
Hyperf 默认不保证 GROUP BY 结果的顺序，尤其当分组字段有多个（如按年月分组），不加 orderBy 可能导致前端分页或图表渲染错乱。
- 错误写法：
Db::table('orders')->selectRaw('YEAR(create_time) y, MONTH(create_time) m, SUM(amount) s')->groupBy('y', 'm')->get()—— y/m 顺序不确定 - 正确写法：补上
orderBy('y')->orderBy('m')，或用orderByRaw('y, m') - 若用
YEAR_MONTH(create_time)，记得该函数返回的是整数（如 202608），可直接orderBy数值升序
复杂统计场景建议用原生 SQL + Db::select()
当涉及嵌套聚合（如先分组再取 TOP N）、多层 CASE WHEN、或需要复用子查询结果时，QueryBuilder 表达力受限，硬套易出错。
- 例如“每个用户最近 3 笔订单金额总和”，用 QueryBuilder 很难清晰表达，不如写原生 SQL：
Db::select("SELECT user_id, SUM(amount) FROM (SELECT user_id, amount, ROW_NUMBER() OVER (PARTITION BY user_id ORDER BY create_time DESC) rn FROM orders) t WHERE rn - 注意参数绑定仍要使用
?占位符，避免拼接字符串引发 SQL 注入 - 返回结果是数组，每项为
stdClass对象，字段名按 SQL 中的别名来，不是下划线自动转驼峰
真正容易被忽略的是：Hyperf 的 Db 组件默认开启 prepared statement，但某些聚合函数组合（如 GROUP_CONCAT 配合长文本）可能触发 max_allowed_packet 截断，查不到完整结果却无报错——此时得去 MySQL 服务端确认配置，而不是只查 PHP 层代码。
