withSum() 是最轻量的预加载求和方案,一条SQL通过左连接+SUM()实现;手动join需注意selectRaw别名与GROUP BY匹配;sum()返回单值,withSum()为每模型注入属性;子查询求和仅适用于复杂聚合或分页场景。

用 withSum() 直接在预加载时求和,避免 N+1
当你需要查一批主模型(比如 Order),同时拿到每个订单对应子表(比如 order_items)的金额总和,withSum() 是最轻量、最符合 Eloquent 语义的方案。它底层生成的是左连接 + SUM() 聚合,一条 SQL 搞定全部。
常见错误是把关系名写错,或误传闭包参数:
-
withSum('items')中的'items'必须和模型里定义的关系方法名完全一致(比如public function items() { return $this->hasMany(OrderItem::class); }) - 带条件时闭包必须接收
$query参数,不能漏掉:withSum(['items as total' => function ($query) { $query->where('status', 'active'); }]) - 别在闭包里调
select()或get()—— 这会破坏聚合逻辑,导致报错或空值
示例:$orders = Order::withSum(['items as item_total' => fn($q) => $q->whereNotNull('paid_at')])->get();,结果中每个 $order->item_total 就是该订单已支付项的金额和。
用 selectRaw() + leftJoin() 手动聚合,控制粒度更细
当 withSum() 不够用——比如要跨多层关联、要加复杂过滤、或需同时取多个不同条件的和(如“今日点击数”和“历史总点击数”),就得退到查询构建器层面手动写 LEFT JOIN 和 SUM()。
关键点在于字段别名和 GROUP BY 的匹配:
- 主表字段必须显式列出,不能只写
*,否则GROUP BY会出错(MySQL 5.7+ 严格模式下) -
selectRaw()里的SUM()别名要和后续 PHP 中访问的属性名一致,比如SUM(clicks.total) as today_clicks→ 用$row->today_clicks - 记得
mergeBindings()如果子查询带参数,否则 where 条件不生效
示例:DB::table('affiliates')->leftJoin('referral_clicks as clicks', 'clicks.affiliate_id', '=', 'affiliates.id')->selectRaw('affiliates.*, SUM(clicks.clicks) as total_clicks')->groupBy('affiliates.id')->get();
sum() 和 withCount() 别混用:一个是标量值,一个是模型集合属性
Model::sum('field') 返回单个数字,适合统计全表或简单条件下的总和;而 withSum() 或 withCount() 是为每个模型实例注入一个新属性,返回的是模型集合。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
容易踩的坑:
- 写
Order::withSum('items')->sum('item_total')是错的——withSum()后的数据还没 hydrate 成属性,sum()找不到item_total字段,会返回 0 或报错 - 想对预加载后的集合再求和,得用集合方法:
$orders->sum('item_total'),但这发生在 PHP 层,数据量大时有性能风险 -
withCount()只计数,不能替代withSum();两者语法相似但底层 SQL 完全不同,别指望withCount(['items as total'])能返回金额和
子查询求和慎用,除非真需要隔离逻辑或分页兼容
子查询求和(比如先算每个订单的 SUM(amount),再拿结果 join 主表)写法灵活,但代价明显:MySQL 需要物化临时表,大数据量下性能跳崖。Laravel 官方文档也明确建议优先用 withSum() 或 join。
只有两种情况值得考虑子查询:
- 聚合逻辑极其复杂,涉及窗口函数或多次嵌套,
JOIN写不出来 - 你正在分页,且主表和子表一对多关系导致
JOIN后重复行干扰count()总数(此时可用子查询先聚合再分页)
示例结构(非推荐,仅说明):$sub = DB::table('order_items')->selectRaw('order_id, SUM(amount) as sum_amount')->groupBy('order_id'); DB::table('orders')->select('orders.*', 'sub.sum_amount')->joinSub($sub, 'sub', 'sub.order_id', '=', 'orders.id')->get();
真正难处理的不是语法,而是聚合后数据一致性:比如订单状态变更后,缓存里的 item_total 没刷新,或并发修改子表时没加事务锁。这些地方比怎么写 SQL 更容易出问题。










