wherehas()是查询“至少拥有一个指定关联记录”的标准方法，生成exists子查询，支持链式条件和中间表字段过滤，三参数形式可实现“全部匹配”，需配合唯一索引与预加载with()避免n+1。
sync() 不是查询方法，别在查数据时用它——它只改数据，不返回关联记录。
whereHas() 是查“有任意匹配”的标准写法
想查“至少拥有一个指定角色的用户”，直接用 whereHas() 最干净：
- 它生成带 EXISTS 子查询的 SQL，性能可控，且支持链式条件
- 中间表字段可直接在闭包里过滤，比如
$q->where('activated_at', '!=', null) - 不加第三个参数时，默认语义是 “≥1 条匹配”，不是“等于”或“全部”
- 错误写法：
User::whereHas('roles', fn($q) => $q->where('id', 1))->get()—— 匿名函数语法在 PHP 8.0+ 才支持，低版本会报错；稳妥起见用function ($q) { ... }
whereHas(..., '=', $count) 实现“全部关键词匹配”
业务要求“用户必须同时拥有 ['admin', 'editor', 'publisher'] 这三个角色”，不能只靠 whereIn() —— 那是“任一满足”。正确姿势是利用 whereHas() 的三参数重载：
- 第三个参数传
'='和count($terms)，Laravel 会自动加HAVING COUNT(*) = ? - 注意：这保证“至少含全部关键词”，但不排除用户多出第四个角色（如 'guest'）；若需严格等于，得额外加
whereDoesntHave('roles', fn($q) => $q->whereNotIn('name', $terms)) - 中间表必须有
UNIQUE(user_id, role_id)约束，否则重复记录会导致计数虚高，结果不准 - 数据库索引建议：在
role_user(role_id, name)或role_user(user_id, name)上建联合索引，加速whereIn+HAVING计算
with() 预加载后取关联数据，别在循环里查
要展示用户及其所有角色名称列表（比如渲染成 badge），别写 foreach ($users as $u) { echo $u->roles->pluck('name')->join(', '); } —— N+1 查询立马拖垮接口。
- 用
with('roles')一次性预加载，Eloquent 自动合并查询 - 如果只想要角色名数组、不要整个
Role对象，加select('id', 'name')减少传输量：with(['roles' => fn($q) => $q->select('id', 'name')]) - 中间表字段要用
withPivot()显式声明，否则$user->roles->first()->pivot->activated_at会报错或返回 null - 模型定义里漏了
withPivot('activated_at')，就算数据库里有这列，pivot对象也拿不到 —— 这点极易忽略
真正麻烦的从来不是“怎么写”，而是“什么时候该用 whereHas、什么时候该用 with、什么时候又得手写子查询”。边界模糊时，先看 SQL 要返回什么：只返回主模型？用 whereHas；要连带关联数据？用 with；要精确控制聚合逻辑？那就得上 DB::table 或原生子查询。
