Laravel自定义属性未被请求仍加载关联关系的解决方案问询

最优解决方案：使用闭包包装属性访问逻辑 #

你遇到的核心问题是Laravel资源类的when方法如果直接传入属性表达式，会在条件判断前就提前执行属性访问，触发关联加载。只要将属性调用放到闭包中即可解决：

// Resource 优化后写法
public function toArray($request)
{
    return [
        'id'         => $this->id,
        'squad_name' => $this->when(
            array_key_exists('squad_name', $this->resource->toArray()), 
            fn() => $this->squad_name // 仅条件满足时才执行，触发属性访问
        ),
        'slots'      => SlotResource::collection($this->whenLoaded('slots')),
    ];
}

这种写法完全不需要堆砌if判断，和你原来的代码结构几乎一致，不会影响可读性。

原理说明 #

Laravel资源类的when方法会判断第一个参数的真值：

• 若为真，才会执行第二个参数传入的闭包、获取返回值作为字段值
• 若为假，直接忽略该字段，不会执行闭包内的逻辑，自然也不会触发自定义属性的关联加载

进阶优化方案：统一检测append参数 #

如果项目里大量用到spatie query builder的动态append功能，可以在基础资源类封装一个公用方法，进一步简化重复代码：

// 基础资源类 app/Http/Resources/BaseResource.php
public function whenAppended(string $attribute, mixed $value = null)
{
    return $this->when(
        array_key_exists($attribute, $this->resource->toArray()),
        $value ?? fn() => $this->{$attribute}
    );
}

// 业务资源类调用
public function toArray($request)
{
    return [
        'id'         => $this->id,
        'squad_name' => $this->whenAppended('squad_name'),
        'other_append_attr' => $this->whenAppended('other_append_attr'),
        'slots'      => SlotResource::collection($this->whenLoaded('slots')),
    ];
}

后续新增需要动态追加的属性时，只需要加一行代码即可，完全不需要重复写判断逻辑。

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