中间表字段需用 withPivot() 显式声明才能通过 pivot 属性访问，如 $user->roles[0]->pivot->is_primary；保存时须用 attach()/sync() 传额外字段数组，不可用 save()/create()；查询需用 wherePivot() 而非 where()。
中间表字段怎么在 belongsToMany 关系里取出来
直接调用关联模型的属性拿不到中间表字段，比如你定义了 User 和 Role 的多对多关系，中间表 role_user 里有 created_at、is_primary 这类字段，它们不会自动挂到 Role 实例上。
必须显式用 withPivot() 声明要携带的字段：
class User extends Model
{
public function roles()
{
return $this->belongsToMany(Role::class)->withPivot('is_primary', 'created_at');
}
}
之后就能通过 $user->roles[0]->pivot->is_primary 访问。漏掉 withPivot() 就会报 Undefined property: Illuminate\Database\Eloquent\Relations\Pivot::$is_primary 错误。
怎么给中间表写额外字段（非外键）并保存
插入新关联时，不能只传两个外键 ID，额外字段必须用 attach() 或 sync() 的第二个参数传数组，格式是 [关联ID => [字段 => 值]]。
立即学习“PHP免费学习笔记（深入）”；
-
attach()是追加：$user->roles()->attach($roleId, ['is_primary' => true, 'created_at' => now()]) -
sync()是全量覆盖：$user->roles()->sync([$roleId => ['is_primary' => false]])，未列出的关联会被删掉 - 别用
save()或create()，它们操作的是主模型，不是中间表
如果中间表字段没设默认值又没传，MySQL 会报 Field 'xxx' doesn't have a default value —— Laravel 不会帮你补空值。
中间表有自增主键时，detach() 和 sync() 还安全吗
安全，但要注意：Laravel 默认把中间表当纯关联表，不预期它有主键。如果你加了 id 自增主键，detach() 和 sync() 依然只按外键匹配删除，不会动 id 字段本身。
不过有两点容易踩坑：
- 用
updateExistingPivot()时，它靠外键定位记录，不是靠id，所以即使有主键也不影响 - 手动查中间表要用
new Pivot或直接查DB::table('role_user')，别试图用RoleUser::find($id)—— Laravel 没为中间表建模型，硬建会绕过 Eloquent 关联逻辑 - 迁移里如果加了
$table->id()，记得同时加复合唯一索引：$table->unique(['user_id', 'role_id'])，否则重复关联可能意外成功
想查“用户拥有某角色且 is_primary = 1”的数据，怎么写 where 条件
不能写 $user->roles()->where('is_primary', 1)->get()，这会去查 roles 表里的 is_primary 字段（根本不存在）。
必须用 wherePivot()：
$primaryRoles = $user->roles()->wherePivot('is_primary', 1)->get();
也支持 wherePivotIn()、wherePivotBetween() 等变体。注意它只作用于当前查询的 pivot 数据，不影响后续调用——比如链式调用 ->withPivot('is_primary')->wherePivot(...) 才能确保字段可读。
复杂条件如 “is_primary = 1 且 created_at 在本周内”，得用 wherePivot() + wherePivotBetween() 组合，或者干脆用 DB::table('role_user') 写原生 join，Eloquent 的 pivot 查询能力有限。
