Laravel API资源集合报错 Property [name]不存在于集合实例

报错Property [name] does not exist on this collection instance的核心原因是混淆了Laravel API资源中单条资源与集合资源的使用逻辑：

• 你当前创建的InstructorCollection是集合资源类，接收的参数是User::where('type',3)->get()返回的包含多个User模型的集合实例
• 你在集合类的toArray方法中直接用$this->name访问属性，相当于尝试从集合实例本身读取name属性，但name、email这类字段只属于集合内的单个User模型实例，集合本身没有这些属性，因此触发报错
• 直接返回原始$instructors查询结果不报错，是因为Laravel默认序列化集合时，会遍历集合内的每个模型读取属性，不会尝试访问集合本身的字段。

1. 新建单条资源类 #

先运行Artisan命令生成处理单个User模型的资源类：

php artisan make:resource InstructorResource

将你之前写在Collection类中的字段格式化逻辑，迁移到InstructorResource的toArray方法中：

public function toArray($request)
{
    return [
        'name' => $this->name,
        'email' => $this->email,
        'area_id' => $this->area_id,
        'whatsapp' => $this->whatsapp,
        'phone' => $this->phone,
        'description' => $this->description,
    ];
}

2. 修改集合资源类逻辑 #

打开InstructorCollection文件，修改toArray方法，通过单条资源类遍历格式化集合内的所有模型：

public function toArray($request)
{
    return [
        'data' => InstructorResource::collection($this->collection),
        // 如需追加分页信息、自定义统计字段等集合维度的内容，可在此处添加
    ];
}

3. 修正控制器返回逻辑 #

你原控制器中手动包data键、写无对应值的error键的写法属于冗余逻辑，直接返回集合资源实例即可，Laravel会自动完成JSON序列化：

public function index()
{
    $instructors = User::where('type',3)->get();
    return new InstructorCollection($instructors);
}

如果你不需要给返回的列表追加集合维度的额外数据（比如分页元数据、统计值），可以完全省略单独的Collection类，直接在控制器中调用单条资源的collection方法返回结果：

public function index()
{
    $instructors = User::where('type',3)->get();
    return InstructorResource::collection($instructors);
}

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