Laravel如何筛选关联模型 仅返回匹配搜索条件的关联数据

whereHas方法仅负责筛选存在符合条件关联的主模型，不会对返回的关联数据本身做过滤，要实现「仅返回匹配条件的关联模型」，需要搭配带相同约束的with预加载方法同时使用。

优化后代码 #

// 先抽离公共的标签过滤闭包，保证两处过滤逻辑完全一致
$tagFilter = function ($query) use ($tags) {
    $query->whereIn('tags.name', $tags);
    // 如果要求必须同时匹配所有标签，保留你原来的遍历where逻辑即可
    // foreach ($tags as $tag) {
    //     $query->where('tags.name', $tag);
    // }
};

$toDolists = ToDoList::query()
    // 原有逻辑：筛选出拥有符合标签条件的主模型
    ->whereHas('item.tag', $tagFilter)
    // 新增：预加载关联时同时过滤关联数据，仅保留符合条件的item和对应tag
    ->with([
        'item' => function ($itemQuery) use ($tagFilter) {
            $itemQuery->whereHas('tag', $tagFilter)
                ->with('tag', $tagFilter);
        }
    ])
    ->get();

逻辑说明 #

• 抽离公共闭包是为了保证whereHas和with的过滤规则完全统一，避免出现主模型和关联筛选结果不匹配的问题
• 如果你需要的是「主模型必须同时匹配所有传入标签」，可以把whereIn替换为你原来的遍历where写法；如果是「匹配任意一个标签即可」，whereIn性能更高也更简洁
• 最终返回的结果中，每个ToDoList下的item关联仅会保留符合标签条件的条目，不符合条件的item会被自动过滤，不会出现在返回结果中

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