本文介绍在 Laravel 中使用 Eloquent 作用域进行条件化预加载（如只加载 active 的 subscriptions）时，如何正确处理嵌套关系（如 subscriptions.plan），避免因多次调用 with() 导致先前的闭包过滤被覆盖或忽略。
本文介绍在 laravel 中使用 eloquent 作用域进行条件化预加载（如只加载 active 的 subscriptions）时，如何正确处理嵌套关系（如 subscriptions.plan），避免因多次调用 `with()` 导致先前的闭包过滤被覆盖或忽略。
在 Laravel 应用中，我们常通过模型作用域（Query Scope）封装高频复用的关联查询逻辑。例如，为 User 模型定义一个 scopeWithActiveSubscriptions，用于始终只预加载 active = true 的订阅记录：
// app/Models/User.php
public function scopeWithActiveSubscriptions($query, array $with = [])
{
$baseRelation = [
'subscriptions' => function ($q) {
$q->where('active', true);
}
];
$query->with(array_merge($baseRelation, $with));
}
该设计的关键在于：将所有关联预加载统一收口到单次 with() 调用中。若像原始写法那样先调用 withActiveSubscriptions()（内部执行一次 with(['subscriptions' => ...])），再额外调用 with('subscriptions.plan')，Eloquent 会将后者视为独立、无约束的预加载，从而覆盖或忽略前者的闭包条件——最终导致 subscriptions.plan 被加载，但 subscriptions 本身却包含所有记录（包括 active = false 的）。
✅ 正确用法是将嵌套关系作为参数传入作用域：
$user = User::where('id', 1)
->withActiveSubscriptions(['subscriptions.plan'])
->first();
// ✅ $user->subscriptions 仅含 active = true 的订阅，且每个 subscription 的 plan 已预加载
foreach ($user->subscriptions as $sub) {
echo $sub->plan->name ?? 'No plan';
}
更进一步，你还可以传递带条件的嵌套关系闭包，实现精细化控制：
$user = User::where('id', 1)
->withActiveSubscriptions([
'subscriptions.plan' => function ($q) {
$q->where('type', 'GOLD');
}
])
->first();
⚠️ 注意事项：
- 不要混用 withActiveSubscriptions() 和后续独立的 with() 调用，否则会导致关系重复注册与条件丢失；
- 若需动态组合多个过滤性关联（如同时加载 active 订阅及其 plan 和 invoice.latest），建议统一在作用域内通过 $with 参数注入，保持逻辑集中；
- 该方案兼容 Laravel 8+，对 withCount、whereHas 等其他关联操作无影响，可安全与其他作用域链式调用。
总结：Eloquent 的 with() 方法不支持“叠加”闭包条件，每次调用都会重置对应关系的加载规则。因此，所有受约束的嵌套关系必须在同一个 with() 数组中声明并配置闭包——将这一原则封装进可扩展的作用域，是构建健壮、可维护关联查询逻辑的最佳实践。
