Laravel Eloquent搜索报错：Collection属性不存在于集合实例

算力阿峰

2026-8-12

问题原因

$cut = Cut::...->get() 返回的是Eloquent集合（包含多个Cut模型实例），而->Collection是单个Cut模型实例上的关联属性，你直接在集合上调用这个属性自然会报错：Property [Collection] does not exist on this collection instance.

两种正确解决方式

方式一：数据库层面提前过滤（推荐，性能最优）

用whereHas在查询构建阶段就过滤关联的Collection数据，避免先加载所有数据再用PHP过滤：

// 先构建查询，不立即执行get()
$cutQuery = Cut::with('cutStatus', 'Collection', 'CollectionOrder', 'CollectionOrder.collectionColor')
    ->orderBy('end_date', 'DESC')
    ->where('cut_status_id', 3);

// 有搜索条件时，添加关联过滤
if ($request->search) {
    $cutQuery->whereHas('Collection', function ($query) use ($request) {
        $query->where('customer_code', 'LIKE', "%{$request->search}%");
    });
}

// 最后执行查询获取结果
$cut = $cutQuery->get();

方式二：集合层面过滤（仅适合数据量极小的场景）

如果必须先加载所有数据，用filter()遍历集合，检查每个模型的关联是否符合条件：

$cut = Cut::with('cutStatus', 'Collection', 'CollectionOrder', 'CollectionOrder.collectionColor')
    ->orderBy('end_date', 'DESC')
    ->where('cut_status_id', 3)
    ->get();

if ($request->search) {
    $searchTerm = $request->search;
    $cut = $cut->filter(function ($cutItem) use ($searchTerm) {
        // 处理Collection可能为null的情况，避免报错
        return $cutItem->Collection && str_contains($cutItem->Collection->customer_code, $searchTerm);
    });
}

额外注意