在 Laravel 中，当对关联模型使用 with() 链式调用多个嵌套关系（如 subscriptions.plan）时，先前通过作用域（scope）设置的 where 过滤（如仅加载 active = true 的订阅）会被覆盖失效。本文提供一种灵活、可复用的解决方案，确保过滤逻辑与嵌套预加载协同工作。
在 laravel 中，当对关联模型使用 `with()` 链式调用多个嵌套关系（如 `subscriptions.plan`）时，先前通过作用域（scope）设置的 `where` 过滤（如仅加载 `active = true` 的订阅）会被覆盖失效。本文提供一种灵活、可复用的解决方案，确保过滤逻辑与嵌套预加载协同工作。
Laravel 的 Eloquent 在处理多个 with() 调用时，会将后续调用视为独立的预加载指令——这意味着 ->with('subscriptions.plan') 会绕过你在 scopeWithActiveSubscriptions() 中为 'subscriptions' 定义的闭包约束，转而发起一个无条件的嵌套加载，从而导致 active = false 的订阅也被拉取并关联到结果中。
根本原因在于：Eloquent 不会自动合并重复关系的加载约束。当你先调用 ->withActiveSubscriptions()（它内部注册了带 where('active', true) 的 subscriptions），再额外调用 ->with('subscriptions.plan')，框架会把后者解释为“请重新加载 subscriptions 关系（无闭包），并顺带加载其 plan”，从而覆盖前者的过滤逻辑。
✅ 正确做法是：将嵌套关系的加载需求统一收口到作用域内，避免外部 with() 干扰。我们改造 scopeWithActiveSubscriptions()，使其支持动态注入关联路径及可选约束：
// app/Models/User.php
public function scopeWithActiveSubscriptions($query, array $nestedRelations = [])
{
// 构建基础 subscriptions 约束
$relations = [
'subscriptions' => function ($q) {
$q->where('active', true);
}
];
// 合并用户传入的嵌套关系（如 ['subscriptions.plan', 'subscriptions.invoice']）
foreach ($nestedRelations as $relation => $constraint) {
if (is_string($relation)) {
// 若键为字符串（如 'subscriptions.plan'），值为闭包或 null
$key = $relation;
$value = is_callable($constraint) ? $constraint : null;
} else {
// 若为索引数组（如 ['subscriptions.plan']），则键值相同
$key = $constraint;
$value = null;
}
// 自动推导父级关系并附加约束（仅当非 subscriptions 本身）
if (str_starts_with($key, 'subscriptions.')) {
$relations[$key] = $value;
}
}
return $query->with($relations);
}
使用方式如下：
// ✅ 正确：所有预加载逻辑由作用域统一管理
$user = User::where('id', 1)
->withActiveSubscriptions(['subscriptions.plan'])
->first();
// ✅ 支持自定义嵌套约束（例如只加载 GOLD 类型的 plan）
$user = User::where('id', 1)
->withActiveSubscriptions([
'subscriptions.plan' => function ($q) {
$q->where('type', 'GOLD');
}
])
->first();
// ✅ 支持多级嵌套（如 plan.features）
$user = User::where('id', 1)
->withActiveSubscriptions(['subscriptions.plan.features'])
->first();
⚠️ 注意事项：
- 不要再链式调用 ->with('subscriptions.*')，否则仍会触发冲突；
- 若需加载 User 自身其他无关关系（如 profile），可安全追加：->with('profile')->withActiveSubscriptions([...])，因关系名不重叠；
- 该方案兼容 Laravel 9.x 及以上版本，闭包约束语法与官方文档一致；
- 对于复杂场景（如需动态判断是否启用 active 过滤），可进一步将 where('active', true) 提取为参数，增强作用域通用性。
通过将预加载职责集中到作用域，你不仅解决了过滤丢失问题，还提升了代码一致性与可维护性——所有“活跃订阅及其关联数据”的查询逻辑，现在真正做到了一处定义、多处复用。
