在Laravel里处理嵌套关联的聚合查询，是许多后台统计接口绕不开的需求。比如我们要从订单出发，统计每个订单对应客户的上一级代理商下面的所有客户订单总金额。这种跨三层的关系如果只用常规的with加withSum，经常拿到错误甚至为空的结果。理解Laravel如何构造嵌套关联的SQL，是写出正确聚合查询的前提。
嵌套关联聚合的底层约束原理
Laravel的关联分为一对一、一对多、多对多等，嵌套关联通常写成with('a.b.c')的形式。当我们在某一层使用withCount或withSum时，这些方法实际上是通过向该层关联查询注入聚合子查询来实现。问题在于，如果你在顶层模型写with('customer.agent:id,name')之后想统计agent下的客户数，必须在闭包中继续对customer或agent使用聚合方法，而不是在顶层直接写withSum('customer.agent', 'amount')，因为Laravel并不会把聚合自动穿透到未声明的深层关联。
从生成的SQL看，嵌套with会产生多条独立查询，而非单条join。例如先查订单，再查客户，再查代理商。如果在客户层加了withCount('orders')，这条计数只绑定在客户模型上，代理商模型如果不显式声明withSum('customers', 'amount')，就无法拿到汇总。很多开发者误以为链式写法会顺带统计，其实每层聚合都要在该层关联定义里明确指定。
另外一个容易忽略的点是关联方法的约束范围。使用with闭包时，闭包接收的是关系查询构造器，你可以调用select、where甚至withSum，但这些操作仅影响这一层取出的数据和附加聚合字段，不会改变父级或子级的查询结构。因此理清层级依赖，是避免聚合错位的核心。
使用with闭包实现正确的嵌套聚合
假设我们有Order模型，关联customer（客户），而Customer关联agent（代理商），Agent又关联多个Customer并希望通过客户统计订单总额。正确写法是在订单查询中嵌套声明各层聚合。下面示例展示如何统计每个订单所属客户的代理商名下所有客户产生的订单总金额。
<?php
use AppModelsOrder;
$orders = Order::query()
->with([
'customer' => function ($query) {
// 客户层：取出客户并嵌套代理商
$query->select('id', 'name', 'agent_id')
->with([
'agent' => function ($q) {
// 代理商层：统计其名下所有客户的订单总额
$q->select('id', 'agent_name')
->withSum('customers as total_amount', 'orders.amount');
}
]);
}
])
->get();
// 访问方式
foreach ($orders as $order) {
$agentTotal = $order->customer->agent->total_amount ?? 0;
echo $order->id . ' 对应代理商总额: ' . $agentTotal;
}
上面的代码中，withSum('customers as total_amount', 'orders.amount')要求Agent模型中定义了customers关联，并且Customer模型中定义了orders关联。Laravel会把total_amount作为虚拟属性挂在agent对象上。这种写法清晰且易于维护，每层只关心自己的聚合。
如果你的嵌套更深，比如代理商上面还有分公司，只需要在对应层继续写with闭包和withSum即可。相比一次性写成字符串'customer.agent.customers.orders'，闭包方式虽然繁琐，但能精确控制每一层要取的字段和聚合逻辑，避免选出无用列导致内存浪费。
要注意的是，使用withSum时第二个参数是“关联名.字段”或者“关联名 as 别名, 字段”，语法容易写错。若写成withSum('customers', 'amount')而amount实际在orders表，就必须用customers.orders.amount或借助hasManyThrough重新定义关联。
selectRaw结合子查询的替代方案
当嵌套层级复杂且只需要最里层汇总结果时，用多层with会产生大量查询。此时可以用selectRaw把聚合写成SQL子查询，直接挂在主模型上。比如我们想给每个订单附加一个字段，表示其客户所属代理商的所有客户订单总额，可以这样做。
<?php
use AppModelsOrder;
use IlluminateSupportFacadesDB;
$orders = Order::query()
->select('orders.*')
->selectRaw(
'(SELECT SUM(o.amount)
FROM customers c
JOIN orders o ON o.customer_id = c.id
WHERE c.agent_id = (
SELECT agent_id FROM customers WHERE id = orders.customer_id
)) AS agent_total'
)
->get();
foreach ($orders as $order) {
echo $order->id . ' 代理商总额: ' . $order->agent_total;
}
这种写法只用一条SQL，性能在大数据量下往往优于多层with，因为数据库优化器可以一次性完成嵌套循环。缺点是SQL写在字符串里，失去了Eloquent关联的可读性，且字段硬绑定表结构，模型关系变更时要同步改SQL。
如果希望兼顾ORM与性能，可以借助hasManyThrough把“代理商到订单”的路径声明出来，再用withSum。例如Agent模型定义ordersThroughCustomers关联指向Order，就能直接Agent::withSum('ordersThroughCustomers', 'amount')。这样既不写原始SQL，又减少查询层数。选择哪种方式，取决于团队对SQL可控性的要求以及统计接口的实时性标准。
实战中建议先用量小数据验证聚合数值，再决定用闭包嵌套还是selectRaw。对于报表类离线统计，子查询更合适；对于详情页附带轻量汇总，闭包with更直观。理解两种思路的边界，才能在处理Laravel嵌套关联聚合时少走弯路。
Laravelnested_relationaggregate_query修改时间：2026-08-15 14:27:30