在Laravel中如何对BelongsToMany关联关系执行搜索查询？

代码存在的问题 #

• 参数注入错误：方法签名中注入的是Project $post实例，但后续查询使用的是Post模型，二者完全不匹配，且路由绑定的单个模型实例无法直接用于批量查询的条件构造。
• 关联查询语法错误：$post->tags()->role写法不符合Laravel关联查询规范，tags()返回的是关联查询构造器，无法直接访问关联表字段作为查询条件。
• 查询逻辑问题：未对orWhere条件分组，会导致后续如果有其他全局查询范围（例如软删除、权限过滤）时逻辑完全失效。
• 语法笔误：关联表like条件末尾错误写为%$query$%，最后一个符号错误应为%$query%`。

正确实现方式 #

要对BelongsToMany关联进行条件查询，需要使用Laravel提供的whereHas方法，该方法会自动构造关联表存在性查询的SQL语句，实现查询满足关联表匹配条件的主表记录，正确代码如下：

public function search(Request $request)
{
  $this->validate($request, [
    'query' => 'required'
  ]);

  $query = $request->input('query');
  $posts  = Post::where('title', 'like', "%{$query}%")
               ->orWhereHas('tags', function ($q) use ($query) {
                    // 这里的tags对应Post模型中定义的关联方法名
                    $q->where('role', 'like', "%{$query}%");
               })->paginate(6);

  return view('post.search', [
    'posts' => $posts,
  ]);
}

如果需要同时加载匹配的标签数据，可以在查询链中追加with('tags')预加载关联，避免N+1查询问题。

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