在启用 Model::preventLazyLoading() 后，直接在 whenLoaded() 中访问未加载关系属性会触发懒加载异常；必须改用闭包形式延迟执行，才能安全规避该问题。
在启用 `model::preventlazyloading()` 后，直接在 `whenloaded()` 中访问未加载关系属性会触发懒加载异常；必须改用闭包形式延迟执行，才能安全规避该问题。
Laravel 9.17+ 中，Model::preventLazyLoading() 是一项关键的性能防护机制，它会在意外触发关系懒加载时抛出 LazyLoadingViolationException，帮助开发者及时发现 N+1 查询隐患。但这一机制也带来一个常见陷阱：当在 API Resource 中使用 whenLoaded('relation', $this->relation->field) 时，即使逻辑上仅在关系已加载时才应访问其属性，PHP 解析器仍会提前求值 $this->relation->field —— 导致无论 whenLoaded() 条件是否满足，关系都会被强制加载，从而触发异常。
根本原因在于运算符优先级：$this->meta->discount ?? 0 是一个表达式，在传入 whenLoaded() 前已被 PHP 完全解析，此时 ->meta 访问已发生，懒加载即被触发。
✅ 正确做法是将属性访问封装进闭包（Closure），确保仅在 whenLoaded() 确认关系已加载后才执行：
// ❌ 错误：提前触发懒加载
'discount' => $this->whenLoaded('meta', $this->meta->discount ?? 0),
// ✅ 正确：延迟执行，安全规避
'discount' => $this->whenLoaded('meta', function () {
return $this->meta->discount ?? 0;
}),
同理，适用于任意关系字段、嵌套访问或复杂逻辑：
'full_name' => $this->whenLoaded('user', function () {
return $this->user->first_name . ' ' . $this->user->last_name;
}),
'avatar_url' => $this->whenLoaded('avatar', function () {
return $this->avatar ? Storage::url($this->avatar->path) : null;
}),
⚠️ 注意事项：
- 闭包内 return 的值将作为 whenLoaded() 的最终返回值；若关系未加载，整个键将被自动排除（不会返回 null 或默认值）；
- 若需提供默认值（如 0 或 null），应在闭包内部处理（如 ?? 0），而非作为 whenLoaded() 的第二个参数；
- 在 Eloquent Collection 或分页响应中，该模式同样适用，且与 with() 预加载完全兼容；
- 建议全局启用 preventLazyLoading()（如在 AppServiceProvider::boot() 中），并配合 phpunit 测试覆盖资源层，确保所有 whenLoaded() 调用均符合闭包规范。
通过这一微小但关键的语法调整，你既能享受懒加载防护带来的稳定性与可维护性提升，又不牺牲 Resource 层的灵活性与可读性。
