detach()和sync()不继承where()条件，必须用wherePivot()过滤中间表字段或先查ID再操作；whereHas多条件需多次调用实现AND逻辑。
直接在多对多关联上链式调用 where() 后再 detach() 或 sync()，不会按条件生效；必须用 wherePivot() 过滤中间表字段，或先查 ID 再显式传入操作方法。
detach() 不继承 where() 条件，只清空全部关联
常见错误是这样写：
$organization->workers()->where('type', 3)->detach();
这看似合理，但 detach() 完全忽略前面的 where()，实际执行的是清空该组织下所有 people 关联记录。原因在于：Eloquent 的 detach() 底层直接删中间表行，不复用关联查询的约束逻辑。
- 它只认
wherePivot()、wherePivotIn()等专用于 pivot 表的过滤器 - 若
type字段在people表（非中间表），则无法用wherePivot()，必须走“先查 ID 再 detach”路径 -
pluck('people.id')中的表别名要和关联定义一致；若自定义了 as 别名（如->as('p')），就得写pluck('p.id')
用 wherePivot() 实现精准 detach（推荐，当 type 在中间表时）
如果 type 是关系上下文属性（比如“此人在此组织中的角色类型”），理应存在中间表 organization_people 中。这时 wherePivot() 是最简方案：
$organization->people()->wherePivot('type', 3)->detach();
这条语句会生成一条带 WHERE organization_people.type = ? 的 DELETE 语句，真正只删符合条件的中间表记录。
- 支持
wherePivotIn()、wherePivotBetween()等变体，语法与普通where一致 - 不支持对 pivot 表以外的字段（如
people.name）过滤——那是whereHas()的职责 - 若中间表无
type字段却硬写wherePivot()，SQL 报错信息为Unknown column 'organization_people.type'
sync() 前必须清洗空 pivot 数据，否则写入 null 记录
前端提交类似 ingredients[1][number1]=x&ingredients[1][number2]= 的数据时，sync() 默认照单全收，把 number2 为 null 的行也写进中间表。正确做法是在调用前过滤：
$ingredients = $request->input('ingredients', []);
$validIngredients = collect($ingredients)
->filter(fn ($data) => !empty($data['number1']) && !empty($data['number2']))
->mapWithKeys(fn ($data, $id) => [$id => $data])
->all();
$recipe->ingredients()->sync($validIngredients);
-
filter()必须显式判断每个 pivot 字段，!empty()能排除null、''、0，按需可换成isset() -
mapWithKeys()是关键：确保输出结构为[1 => ['number1' => 'x', 'number2' => 'y']]，否则sync()会忽略 pivot 数据 - 若漏掉
mapWithKeys()直接传collect(...)->values()->all()，Laravel 会当成纯 ID 数组处理，pivot 字段丢失
whereHas 多条件 AND 过滤，别用单次 whereIn 搞混逻辑
想查“同时拥有标签 A 和标签 B”的用户，不能这样写：
User::whereHas('tags', fn ($q) => $q->whereIn('name', ['A', 'B']));
这表示“拥有 A 或 B”，结果集会包含只打了一个标签的用户。正确方式是对每个标签单独 whereHas()：
$search_terms = ['A', 'B'];
$query = User::query();
foreach ($search_terms as $term) {
$query->whereHas('tags', fn ($q) => $q->where('name', $term));
}
$users = $query->get();
- 每层
whereHas()对应一个独立的EXISTS子查询，数据库层面是 AND 关系 - 若标签名区分大小写，MySQL 默认敏感，需加
whereRaw('LOWER(name) = ?', [strtolower($term)]) - 中间表若无
UNIQUE(user_id, tag_id)约束，重复插入会导致计数虚高，whereHas(..., '=', count())方案也会失效
真正容易被忽略的是：所有这些条件过滤都依赖中间表结构是否合理。如果本该在 pivot 表的字段（如角色、排序、状态）被塞进了主表，wherePivot() 就用不了，detach() 和 sync() 的条件能力就直接打折——这时候重构数据模型比写补丁更治本。
