laravel多对多中间表字段操作必须三步：withpivot()声明、attach()/sync()传值、迁移添加对应列；缺一不可，否则字段为null。
直接说结论：Laravel 多对多关系中附加中间表字段，必须分三步走——withPivot() 声明字段、用 attach() 或 sync() 传值、确保迁移已添加对应列。漏掉任意一步，字段写不进表，读出来也是 null。
中间表字段怎么声明才能被 Eloquent 识别
withPivot() 不是可选配置，是强制开关。没它，Eloquent 就当那些字段不存在，哪怕数据库里真有这列，$user->roles 返回的每个 Role 实例的 pivot 属性里也看不到它们。
- 必须在双方模型的关系方法里都加，比如
User::roles()和Role::users()都要调用->withPivot('note', 'expires_at') - 字段名必须和数据库列名完全一致（大小写敏感），比如列叫
is_active，就不能写成isActive - 如果中间表有
created_at/updated_at，优先用->withTimestamps()，它比手动withPivot('created_at', 'updated_at')更安全，还能自动触发更新
attach() 和 sync() 写字段的写法差异
两者都能写字段，但结构不同，混用会丢数据或报错。
-
attach(1, ['note' => 'test'])：单条记录，第二个参数是字段数组 -
attach([1 => ['note' => 'test'], 2 => ['note' => 'admin']])：批量，键是关联 ID，值是字段数组 -
sync([1 => ['note' => 'renewed'], 2 => ['note' => 'pending']])：全量同步，未列出的 ID 会被删，已存在的会更新字段 -
sync([1, 2])这种不带字段的写法，会清空所有中间表字段值（设为NULL），不是保留原值
为什么 updateExistingPivot() 比 wherePivot() + save() 更可靠
想改某条已有关联的字段，别手写 wherePivot('user_id', 1)->wherePivot('role_id', 2)->first()->update(...)。这种写法在并发场景下容易覆盖他人修改，且绕过了 Eloquent 的 pivot 生命周期钩子。
- 正确做法：
$user->roles()->updateExistingPivot($roleId, ['note' => 'updated']) - 它底层会先查出该 pivot 记录的主键（依赖中间表有
id字段或复合主键），再执行UPDATE，原子性强 - 如果中间表没主键，
updateExistingPivot()会 fallback 到WHERE user_id = ? AND role_id = ?，但此时必须确保外键组合唯一，否则可能误更新多行
自定义 Pivot 模型时最容易忽略的陷阱
一旦用了 ->using(RoleUser::class)，中间表就不再是“透明管道”，而是具有一等地位的模型。这时很多默认行为会失效。
-
withPivot()必须配合using()使用，否则字段不会加载到 pivot 实例上 - 自定义 Pivot 模型必须继承
Pivot，不能继承Model；否则attach()会抛BadMethodCallException - 如果你在
RoleUser里加了访问器（如getAssignedAtAttribute()），它只在通过$user->roles->first()->pivot->assigned_at访问时生效，sync()传入的数组字段不会经过这个访问器处理
最常被跳过的点：中间表迁移里没加 ->nullable() 却在代码里传 null，或者字段类型和 PHP 值类型不匹配（比如数据库是 TINYINT(1)，却传布尔值 true 而不是 1）。这些不会报错，但字段就是存不进去。
