
本文介绍在 laravel 8+ 中,如何对一对多关联(如 buyer → orders)在指定时间范围内,一次性高效获取订单总数、价格总和及手续费总和,避免 n+1 查询并确保条件一致性。
本文介绍在 laravel 8+ 中,如何对一对多关联(如 buyer → orders)在指定时间范围内,一次性高效获取订单总数、价格总和及手续费总和,避免 n+1 查询并确保条件一致性。
在 Laravel 应用中,当需要对关联模型(如 Buyer 与 Orders)进行带条件的聚合统计时,仅使用 withCount() 显然不够——它无法满足对多个字段分别求和的需求。Laravel 8 起新增的 withSum() 方法为此类场景提供了原生支持,配合闭包约束可精准控制统计范围。
以下是一个完整、可直接复用的示例:假设你已定义 Buyer 模型拥有 orders() 一对多关系,且需统计 创建时间 ≥ $dateTo 的所有订单的总数、price 总和与 charge 总和:
$dateTo = now()->subDays(30); // 示例:近30天
$buyers = Buyer::withCount([
'orders' => fn ($query) => $query->where('created_at', '>=', $dateTo)
])
->withSum([
'orders' => fn ($query) => $query->where('created_at', '>=', $dateTo)
], 'price')
->withSum([
'orders' => fn ($query) => $query->where('created_at', '>=', $dateTo)
], 'charge')
->get();
执行后,每个 Buyer 实例将自动附加以下属性:
- orders_count:符合条件的订单数量
- orders_price_sum:price 字段的聚合和(别名格式为 {relation}_{column}_sum)
- orders_charge_sum:charge 字段的聚合和
✅ 关键注意事项:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
- withSum() 仅支持 Laravel 8.0 及以上版本;低版本需通过 selectRaw() + join 或 DB::raw() 手动构建子查询。
- 每个 withSum() 必须单独调用,不可合并为 withSum(['orders' => ...], ['price', 'charge']) —— Laravel 不支持单次调用多列求和。
- 闭包中的 $dateTo 必须通过 use ($dateTo) 显式引入(箭头函数语法下自动处理,但变量作用域仍需确保有效)。
- 所有 withCount 和 withSum 的闭包条件必须严格一致,否则统计口径将不统一,导致业务逻辑错误。
? 进阶建议:若需频繁复用该统计逻辑,可将其封装为 Eloquent Scope(如 scopeWithRecentOrderStats($builder, $dateTo)),提升代码复用性与可维护性。此外,对 created_at 字段建立数据库索引可显著提升查询性能。
通过合理组合 withCount() 与多个 withSum(),你能在一次数据库查询中安全、高效地获取全部所需聚合指标,既符合 Laravel 的声明式风格,又兼顾了生产环境的性能与可读性。










