Laravel多对多需表名、外键、参数全匹配才生效；sync()清空重建非增量；中间表字段须withPivot()显式声明；命名不规范或参数缺失将静默失败。
直接说结论：Laravel 多对多不是“写对了就自动跑通”，而是表名、外键、参数三者全对才生效；sync() 默认清空再重建，不是增量更新；中间表字段不显式声明 withPivot() 就读不到、也写不进。
中间表名和外键字段不匹配时，belongsToMany 必须传全四个参数
默认规则（role_user 表、user_id/role_id 字段）在真实项目里极容易踩空。一旦中间表叫 user_roles 或字段是 uid/rid，只写 $this->belongsToMany(Role::class) 会静默返回空集合，SQL 里还查不存在的字段。
- 查迁移文件确认真实表名：
create_user_roles_table.php还是create_role_user_table.php - 外键字段名必须和数据库完全一致（大小写敏感），比如
uid就不能写成user_id - 四个参数顺序固定：
belongsToMany(关联模型, 中间表名, 当前模型外键, 关联模型外键) - 主键名不为
id时（如 UUID），还得补第五、第六个参数：parentKey和relatedKey
中间表有额外字段（如 assigned_by、expires_at）必须用 withPivot() 声明
哪怕数据库字段已存在，不声明 withPivot()，$role->pivot->assigned_by 就会报错或返回 null；attach() 或 sync() 传的字段也会被静默丢弃。
- 只声明要用的字段：
->withPivot('assigned_by', 'expires_at')，别把中间表所有字段都列进去 - 字段名必须和迁移里定义的完全一致（比如
created_at不是created_at_time） - 想自动维护时间戳，用
->withTimestamps()替代手动写created_at/updated_at - 调用时不能跳过加载：
$user->load('roles')或$user->roles()->withPivot(...)->get()
sync() 清空再重建，不是“保留旧的 + 加新的”
sync([1, 2]) 的语义是“当前列表即全部合法值”，它会先删掉所有旧记录，再插入新 ID。线上事故高发点就在这里——误以为是追加，结果把权限全清了。
- 要追加用
attach()：$user->roles()->attach([3]) - 带额外字段时，
sync()必须用 ID → 字段数组映射：sync([1 => ['activated_at' => now()]])，不能传[1, 2]或sync([1, 2], [...]) -
sync()返回的是被删 ID 数组（Laravel 9+），不是新增的 - 主模型必须已保存（
$user->exists === true），否则外键写入0或null，触发外键约束错误
多态多对多没有现成 morphedByMany，得手动组合实现
Laravel 官方没提供 morphedByMany 这类封装，所谓“文章打标签 + 视频打标签”这种需求，本质是多态 + 多对多叠加，必须靠中间模型 + 手动查询落地。
- 中间表必须独立建，含
tag_id、taggable_id、taggable_type四字段，不能复用普通多对多表 - 必须为
(taggable_type, taggable_id)加联合索引，否则whereHasMorph()全表扫描 - 禁用
attach()/sync()，它们不识别_type字段；得用Taggable::create()或手写insert() - 查“某篇文章有哪些标签”，不能走
$post->tags，得查中间表：Tag::whereDoesntHave('taggables', ...)
最常被忽略的其实是中间表缺失唯一索引，以及 sync() 被当成“安全追加”来用——这两点在线上几乎必出问题。
