laravel多对多关系必须用belongstomany定义，中间表须存在且字段名严格匹配；默认中间表为role_user、外键为user_id/role_id，否则需显式传参，否则attach/sync静默失败或报外键错误。
直接说结论：Laravel 多对多关系必须用 belongsToMany 定义，中间表必须存在且字段名要对得上，否则 attach/sync 会静默失败或报外键错误。
中间表命名和外键字段怎么配才不报错
默认规则是硬编码进 Eloquent 的：中间表名按两个模型类名的字母顺序拼接复数形式（Role + User → role_user），外键默认为 user_id 和 role_id。一旦你建的表叫 user_roles 或外键是 uid/rid，就必须显式传参，否则查不到数据、attach() 插入 NULL。
- 中间表名不对 →
SQLSTATE[42S02]: Base table or view not found - 外键字段名不对 → 插入时外键值为
NULL，触发数据库约束失败 - 主键名不是
id（比如用uuid）→ 必须在belongsToMany第五、六个参数里补上，否则关联查询 WHERE 条件错位
正确写法示例（User 模型中）：
return $this->belongsToMany(Role::class, 'user_roles', 'uid', 'rid', 'uuid', 'role_uuid');
attach / detach / sync 三个方法到底怎么选
它们行为差异极大，混用会导致数据丢失或重复插入：
-
attach($id)：只插入，已存在就报唯一索引冲突（除非中间表没设UNIQUE(user_id, role_id)） -
detach($id)：只删除，传空数组或不传参数会删光所有关联 -
sync([1,2,3])：先删所有旧记录，再插新列表 —— 不是“追加”，是“全量覆盖”
常见误用：
- 想“给用户加个角色”却用了
sync()→ 原有角色全没了 - 想“删掉某个角色”却传了
detach()空参 → 所有角色被清空 - 用
syncWithoutDetaching()以为它会自动去重 → 它只是跳过删除步骤，重复 ID 仍可能报错
中间表有额外字段（比如 assigned_at）怎么读写
不声明 withPivot()，字段就完全不可见；不加 withTimestamps()，created_at/updated_at 不会自动写入。
- 读取字段：必须在
belongsToMany链式调用里加->withPivot('assigned_at', 'level')，然后通过$role->pivot->assigned_at访问 - 写入字段：用
attach()或sync()时传键值对，例如$user->roles()->attach(2, ['assigned_at' => now()]) - 更新已有记录字段：不能靠
attach()，得用updateExistingPivot(2, ['level' => 'admin'])
漏掉 withPivot() 的典型现象：代码不报错，但 $role->pivot 里只有 user_id/role_id，其他字段全空。
sync() 调用前最容易忽略的致命前提
sync() 要求主模型（比如 User）**必须已存入数据库**，即 $user->id 不能为 null 或 0。否则中间表外键写入失败，MySQL 报 Integrity constraint violation: 1452，而 Laravel 默认不抛异常，只返回空结果。
- 错误写法：
$user = new User; $user->fill([...])->save(); $user->roles()->sync([1]);→ 看似 save 了，但如果id是自增且没刷新，sync()仍用0当外键 - 安全写法：
$user = User::create([...]); $user->roles()->sync([1]);或显式$user->refresh()后再调用
这个点在注册流程里特别容易翻车：表单提交后新建用户，紧接着就同步角色/分类，稍不注意就写进一堆 user_id = 0 的脏数据。
