Laravel API Resource传入Null报错，如何解决该问题？

问题解答 #

Laravel API Resource 默认不支持直接传入 null 或空对象，因为 JsonResource 的设计目标是接收有效的 Eloquent 模型实例。当传入 null 时，资源类内部的 $this 会指向 null，直接访问属性就会触发你遇到的"Attempt to read property on null"错误。

解决方法 #

下面提供几种可行的解决方案：

1. 控制器层面提前判断并处理

在获取到模型实例后，先检查是否为 null，再决定返回资源还是符合业务要求的空响应：

// controller
$reseller_id = 903;
$reseller_setting = ResellerSetting::where("reseller_id", $reseller_id)->first();

if (!$reseller_setting) {
    // 根据业务需求返回空结构或默认值
    return response()->json(['id' => null], 200);
}

return ResellerSettingResource::make($reseller_setting);

2. 资源类内部处理null场景

修改资源类，在 toArray 方法里先检查资源是否存在，再返回对应结构：

// resource
class ResellerSettingResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        // 检查资源是否为null
        if (!$this->resource) {
            return [
                "id" => null
            ];
        }

        return [
            "id" => $this->id,
        ];
    }
}

或者使用 Laravel 自带的 optional 辅助函数，简化属性访问的空判断：

// resource
class ResellerSettingResource extends JsonResource
{
    public function toArray(Request $request): array
    {
        return [
            "id" => optional($this)->id,
        ];
    }
}

optional($this)->id 会在 $this 为 null 时返回 null，避免触发错误。

3. 返回空模型实例（可选）

如果需要严格遵循资源响应格式，也可以在控制器中传入空的模型实例：

return ResellerSettingResource::make($reseller_setting ?? new ResellerSetting());

这种方式下，$this->id 会返回 null（需确保模型的id字段允许null），不会触发错误。

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