本文详解 laravel 中 `with(‘relation.nested’)` 语法在批量处理场景下的潜在陷阱，指出其无法保证嵌套模型实例复用的问题，并提供正确预加载、关系缓存及 job/notification 中安全访问关系的完整解决方案。
在 Laravel 中使用 with(‘lease.activeTenant’) 看似能一次性预加载多层关系，但该语法实际仅触发两级查询（leases 和 tenants），且不会将 activeTenant 关系绑定到每个 lease 实例上——它只是将所有匹配的 Tenant 模型“收集”后按 lease_id 分组注入，而 lease->activeTenant 属性本身仍是一个未解析的 HasOneThrough 或 BelongsTo 关系代理。当后续在队列任务（如 GenerateClaimLetter）或通知中多次访问 $invoice->lease->activeTenant 时，Laravel 会重新执行 WHERE tenants.lease_id = ? AND state = ‘active’ 查询，造成严重 N+1 与重复查询。
✅ 正确做法是显式、分层地预加载主关系及其关联模型，并确保关系已真实加载完成：
$invoices = Invoice::query()
->with(['lease', 'lease.activeTenant']) // ✅ 显式数组语法：先加载 lease，再基于已加载的 lease 加载 activeTenant
->whereOverdue()
->whereDate('payment_due_date', Carbon::now()->subWeekdays(5))
->get();
⚠️ 注意：with(‘lease.activeTenant’)（字符串）和 with([‘lease’, ‘lease.activeTenant’])（数组）行为不同：
- 字符串形式会被 Laravel 解析为单个嵌套约束，可能跳过中间模型的实例化；
- 数组形式则明确声明依赖顺序，强制 lease 先被加载并缓存，再以其 id 批量查询 activeTenant，从而真正复用已加载的 Tenant 实例。
此外，在队列任务和通知中，务必避免隐式延迟加载（lazy loading）。即使已预加载，若模型被序列化/反序列化（如通过 Redis 队列传递），关系状态会丢失。因此推荐以下加固策略：
✅ 最佳实践：主动检查并缓存关系
// GenerateClaimLetter.php
public function handle()
{
// 强制使用已预加载的关系，避免意外触发查询
$lease = $this->invoice->relationLoaded('lease')
? $this->invoice->lease
: $this->invoice->load('lease')->lease;
$tenant = $lease->relationLoaded('activeTenant')
? $lease->activeTenant
: $lease->load('activeTenant')->activeTenant;
$content = view('layouts.claim-letter', [
'invoice' => $this->invoice,
'lease' => $lease,
'tenant' => $tenant,
])->render();
// ... 生成 PDF 逻辑
}
? 批处理优化：避免闭包中重复捕获整个集合
你当前的 each() + Bus::batch() 写法会在每次迭代中创建新闭包，且 use($invoice) 无法阻止后续对 $invoice->lease->activeTenant 的重复解析。更稳健的方式是在预加载后立即提取所需数据，仅传递必要字段或 ID 到 Job：
$invoices->each(function (Invoice $invoice) {
// 提前提取关键 ID，避免序列化模型引发关系丢失
$invoiceId = $invoice->id;
$leaseId = $invoice->lease->id ?? null;
$tenantId = $invoice->lease->activeTenant?->id ?? null;
Bus::batch([
new GenerateClaimLetter($invoiceId, $leaseId, $tenantId),
])->finally(function (Batch $batch) use ($tenantId, $invoiceId) {
// 通知也基于 ID 查询，确保一致性
if ($tenantId && $invoice = Invoice::with('lease.activeTenant')->find($invoiceId)) {
$tenant = $invoice->lease->activeTenant;
$tenant?->notify(new InvoiceClaimNotification($invoice));
}
})->dispatch();
});
? 总结
- ❌ 避免 with(‘a.b.c’) 单字符串嵌套预加载，改用 with([‘a’, ‘a.b’, ‘a.b.c’]) 显式分层；
- ✅ 在队列任务中始终校验 relationLoaded()，必要时主动 load()；
- ✅ 对于跨进程（队列）场景，优先传递 ID 而非完整模型，减少序列化副作用；
- ✅ 使用 Laravel Telescope 或 Debugbar 验证最终 SQL —— 正确优化后，N 条发票应仅产生 3 条查询（invoices + leases + tenants），而非数十次重复。
遵循以上模式，可将原本 41 次查询（含 28 次重复）稳定降至理论最小值，显著提升批处理性能与系统可扩展性。