如何在Laravel多层关联中使用whenLoaded()方法？

你说的这个情况确实很常见——whenLoaded()本身只负责检查当前层级的关联是否被预加载，当你在闭包里直接访问$this->origin->season时，如果origin已经加载但season没加载，Laravel的懒加载机制就会自动触发查询，导致讨厌的N+1问题。

针对你这种两层条件关联的场景，有两种比较优雅的解决方式，核心思路都是确保内层关联也被预加载后才返回资源：

方法一：嵌套使用whenLoaded #

直接在第一层whenLoaded的闭包里，再嵌套一层whenLoaded来检查内层的season关联是否已加载：

'season' => $this->whenLoaded('origin', function () {
    // 只有当origin的season也被预加载时，才返回SeasonResource
    return $this->origin->whenLoaded('season', function () {
        return new SeasonResource($this->origin->season);
    });
})

这样一来，只有当你在查询时明确用with('origin.season')预加载了两层关联，这个season字段才会出现在响应里；如果只加载了origin没加载season，或者干脆没加载origin，这个字段会被自动忽略，完全不会触发懒加载。

方法二：手动检查关联加载状态 #

如果你觉得嵌套whenLoaded不够直观，也可以用relationLoaded()方法手动判断两层关联是否都已加载：

'season' => $this->when(
    // 同时验证origin和origin.season都被预加载
    $this->relationLoaded('origin') && $this->origin->relationLoaded('season'),
    function () {
        return new SeasonResource($this->origin->season);
    }
)

这种写法逻辑更直白，和嵌套whenLoaded的效果完全一致，都是避免触发不必要的懒加载。

额外提醒：查询时的预加载配合 #

因为你的origin和season都是条件性关联，记得在查询模型时也要动态控制预加载，比如根据请求参数来决定是否加载这两层关联：

$models = YourModel::query()
    ->when($request->needsOriginAndSeason(), function ($query) {
        return $query->with('origin.season');
    })
    ->get();

这样就能完美匹配你的业务场景——只有当需要用到这些关联数据时，才会一次性预加载，彻底杜绝N+1问题。

内容的提问来源于stack exchange，提问作者Fredrik