Laravel多对多关联需表名、外键、参数三者全对才生效；中间表名须显式指定，外键字段不匹配时需补全四个参数，访问中间表字段须用withPivot()声明，sync()会清空重建而非增量更新，且中间表必须加唯一索引。
多对多关联不是“写对了就能用”，而是“表名、外键、参数三者全对才生效”——Laravel默认推导规则极容易踩空，尤其在非标准命名下，belongsToMany 返回空集合却不报错，是最隐蔽的坑。
中间表名不按字母序？必须显式传参
Laravel 默认把 User 和 Role 拼成 role_user（按字母升序），不是 user_role。如果你的迁移建的是 user_roles 表，$user->roles() 会静默失败。
- 查迁移文件确认真实表名：
create_user_roles_table.php或create_role_user_table.php - 模型中必须写死：
return $this->belongsToMany(Role::class, 'user_roles'); - 别依赖 IDE 自动补全的“无参版本”，它只适用于完全遵守约定的场景
外键字段不是 user_id/role_id？四个参数一个都不能省
一旦中间表字段叫 uid 和 rid，或 user_id 和 group_id，只传表名不够，Eloquent 仍会去查 user_id 和 role_id。
- 四个参数顺序固定：
belongsToMany(关联模型, 中间表名, 当前模型外键, 关联模型外键) - 例如：
return $this->belongsToMany(Group::class, 'user_groups', 'uid', 'group_id'); - 漏掉第 3 或第 4 个参数，查询 SQL 里会出现
WHERE role_user.user_id = ?这种不存在的字段，结果为空
要读中间表字段（比如 assigned_by）？withPivot() 不是可选，是必填
$user->roles 返回的是 Role 实例集合，$role->pivot 默认只有 user_id 和 role_id。想访问 assigned_by 或 expires_at，必须提前声明。
- 在关联方法里加：
->withPivot('assigned_by', 'expires_at') - 调用时不能跳过加载：
$user->load('roles')或$user->roles()->withPivot(...)->get() - 如果中间表有 10 个附加字段但只用 1 个，就只写那 1 个——
withPivot()不影响查询性能，但写多了徒增维护负担
sync() 清空再重建，不是“保留已有 + 补新”
sync() 的语义是“以当前数组为唯一权威”，不是增量更新。这是线上事故最高发点。
-
$user->roles()->sync([1, 2])：删掉所有旧记录，只留 role_id=1 和 2 的两行 - 想追加而不清空，用
attach()：$user->roles()->attach([3]) - 带额外字段写入时，
sync()要用键值数组：$user->roles()->sync([1 => ['assigned_by' => 5]])，未列出的 ID 仍会被删
最常被忽略的其实是中间表缺失唯一索引——sync() 和 attach() 在没有 UNIQUE(user_id, role_id) 约束时可能写入重复行，后续 detach() 也只会删一条，逻辑就乱了。
