belongsToMany 必须显式指定中间表名和外键，否则静默失效；参数顺序固定为（关联模型、中间表名、当前模型外键、关联模型外键）；额外字段需 withPivot() 显式声明，sync() 是先删后插，中间表须设联合主键。
不显式指定中间表名和外键，belongsToMany 关联大概率静默失效——查不到数据、sync() 写错字段、attach() 插入空行，但 Laravel 一句错误提示都不会抛。
belongsToMany 参数顺序必须对得上中间表字段
四个核心参数缺一不可，且顺序固定：belongsToMany(关联模型, 中间表名, 当前模型外键, 关联模型外键)。Laravel 不会“猜”你中间表里哪列存的是用户 ID，它只按你写的参数去拼 SQL。
- 中间表叫
user_role，但字段是uid和rid？那就得写->belongsToMany(Role::class, 'user_role', 'uid', 'rid') - 中间表是
followers，当前用户是被关注者？那外键是followed_id，对方是follower_id：->belongsToMany(User::class, 'followers', 'followed_id', 'follower_id') - 漏掉第 2 个参数（表名），Laravel 就按默认规则推导
role_user；漏掉第 3 或第 4 个，就用id字段当外键——而你的表里根本没有这个字段
中间表额外字段读不到？withPivot() 不是可选项
默认情况下，$user->roles 返回的每个 Role 实例里，$role->pivot 只有 user_id 和 role_id。哪怕中间表有 assigned_by、expires_at、index，不声明就等于不存在。
- 必须在关联方法里加
->withPivot('assigned_by', 'expires_at') - 字段名写错或漏写，运行时不会报错，但
$role->pivot->assigned_by永远是null - 如果字段很多但只用其中一两个，别全塞进
withPivot()——Eloquent 会为每个字段 SELECT，影响查询性能
sync() 不是“更新”，是“先删后插”，额外字段必须手动传
sync([1, 2]) 看似简单，实际执行的是：DELETE 所有旧记录 → INSERT 新记录。中间表里的 created_at、updated_at、assigned_by 全部丢失，除非你主动喂进去。
- 想保留时间戳？用
->withTimestamps()，它会自动填created_at和updated_at - 想带管理员 ID？必须用带键数组：
$user->roles()->sync([1 => ['assigned_by' => 99], 2 => ['assigned_by' => 99]]) - 想批量给所有新记录加同一字段？
attach()支持第二参数：$user->roles()->attach([1, 2], ['assigned_by' => 99]) -
updateExistingPivot()只改已有记录，不新增不删除，适合修单条中间表数据
中间表没联合主键，detach() 可能删错行
如果中间表只有自增 ID 主键（比如 id），没有把 (user_id, role_id) 设为联合主键，detach() 或 sync() 删除时可能因 WHERE 条件不精确而误删。
- Laravel 的 DELETE 语句靠外键组合定位，不是靠自增 ID
- 例如中间表有两条记录：
(user_id=1, role_id=2)和(user_id=1, role_id=3)，但没设联合主键，数据库允许重复插入相同组合——这时detach(2)可能删掉多行 - 线上库务必确认中间表结构：
SHOW CREATE TABLE user_role，确保有类似PRIMARY KEY (user_id, role_id)的定义
