ThinkPHP 8 中间表操作静默失败的五大原因：1. 中间表名未按字母序小写规则（如 user_role 需显式设 $pivotTable）；2. 外键字段名非“模型名_id”格式导致写入0；3. withPivot() 字段需通过 $role->pivot 访问；4. 中间表操作不触发模型事件与验证；5. 不校验外键存在性，依赖数据库约束报错。
中间表名不匹配导致 attach() 静默失败
升级到 ThinkPHP 8 后，attach()、sync() 等方法突然不写入数据，日志里也无报错，大概率是中间表名没对上。TP8 的 belongsToMany() 不再宽容推导——它严格按字母序拼接小写表名（如 User + Role → role_user），若你旧项目用的是 user_role 或 auth_assignment，就会直接跳过写入，甚至返回空结果而非报错。
- 先确认当前中间表真实名称：查数据库，看实际表名是
role_user还是auth_assignment - 若表名不符合字母序小写规则，必须在模型中显式声明：
protected $pivotTable = 'auth_assignment'; - 别只改迁移文件或 SQL 建表语句——TP8 不读建表语句，只认模型里写的
$pivotTable或默认推导逻辑
外键字段名写错引发 sync() 写入 0
即使表名对了，sync([1,2,3]) 仍可能把 user_id 或 role_id 字段全写成 0。这是因为 TP8 要求外键字段名必须是「模型名小写 + _id」，比如 User 模型对应 user_id，不能是 uid、user_id_fk 或 U_ID。一旦不匹配，ORM 就无法提取主键值，默默填 0。
- 检查中间表结构：
DESCRIBE role_user;确认字段确实是user_id和role_id - 在
User模型的关联方法里补全四个参数：return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id'); - 若你的
User模型主键不是id（比如叫uid），还得额外指定：return $this->belongsToMany(...)->foreignKey('uid')->otherKey('role_id');
withPivot() 加了但 pivot 属性还是空
withPivot(['expired_at']) 加了，$user->roles 返回的集合里却看不到 expired_at 字段？这不是 bug，是设计如此：该字段只挂在 $role->pivot 下，不是直接平铺在 $role 对象上。很多人漏掉这层访问路径，以为配置没生效。
- 正确取法：
foreach ($user->roles as $role) { echo $role->pivot->expired_at; } - 如果要连带主表字段一起查（比如角色名 + 过期时间），得用
withPivot()+ 显式select()：$user->roles()->withPivot('expired_at')->select('name', 'pivot_expired_at as expired_at')->get(); - 注意：TP8 不支持
via()方法，别在模型里写via('pivot')，那会直接报错
升级后中间表操作绕过模型事件
你在 User 模型里写了 event('UserAfterAttach')，但 $user->roles()->attach(5) 根本不触发。这是 TP8 的明确行为：中间表写入走的是原生 SQL 插入（INSERT INTO role_user），不经过模型生命周期，也不调验证器、不发事件、不跑自动时间戳。
- 需要记录操作人或时间，必须手动处理：
Db::name('role_user')->insert(['user_id' => $user->id, 'role_id' => 5, 'created_by' => Auth::id(), 'created_at' => date('Y-m-d H:i:s')]); - 涉及业务强一致（如开通 VIP 同时绑定 3 个角色），务必包事务：
Db::transaction(function () use ($user) { $user->roles()->sync([1,2,3]); Order::create([...]); }); - 别依赖
sync()自动填充updated_at——中间表没这个字段或没开启，它就不会写
最常被忽略的点：TP8 的中间表操作不校验外键是否存在。哪怕你传了个不存在的 role_id = 999，attach() 依然成功返回，只在数据库层面靠外键约束报错。线上环境若没开严格外键或没捕获异常，就会埋下静默脏数据。
