thinkphp 8 中 belongstomany 必须显式传入全部六个参数：关联模型类、中间表名、当前模型外键、关联模型外键、当前主键字段、关联主键字段；否则易报错或查不到数据。
ThinkPHP 5 升级到 ThinkPHP 8 后，belongsToMany 的中间表推导逻辑没变，但默认行为更严格——不显式声明中间表名和外键，几乎必然查不到数据或报 Table not found 错误。TP8 不再容忍模糊约定，必须写死参数。
TP8 中 belongsToMany 必须传全四个参数
TP5 有时靠约定能蒙混过关（比如中间表叫 user_role 却写了 belongsToMany('Role', 'role_user')，可能因字段碰巧对上而没报错），TP8 会直接拒绝执行。四个参数顺序固定、缺一不可：
-
Role::class：关联模型类（不能是字符串，TP8 已废弃字符串模型名） -
'user_role'：中间表名（不含数据库前缀，且必须与真实表名完全一致，大小写敏感） -
'user_id'：当前模型（如User）在中间表中的外键字段名 -
'role_id'：关联模型（如Role）在中间表中的外键字段名
示例（User.php）：
public function roles()
{
return $this->belongsToMany(Role::class, 'user_role', 'user_id', 'role_id');
}
若你的中间表字段是 uid 和 rid，就绝不能写成 user_id/role_id，否则 SQL 里会查不存在的字段，返回空集合且无提示。
中间表有额外字段时，withPivot() 不可省略
TP5 可能默认把中间表字段塞进 pivot，TP8 默认只加载外键字段。哪怕数据库里有 created_at、is_primary，不显式声明就拿不到。
正确写法：
public function roles()
{
return $this->belongsToMany(Role::class, 'user_role', 'user_id', 'role_id')
->withPivot(['created_at', 'is_primary']);
}
注意：withPivot() 传的是字段数组，不是字符串；字段名必须和迁移中定义的完全一致（比如是 assigned_at 就不能写成 created_at）。
sync()、attach()、detach() 在 TP8 里行为更“诚实”
TP8 不再静默忽略非法 ID 或跳过字段写入。常见踩坑点：
-
sync([1, 2, 3])会先删光旧记录再插新 ID，不是“保留已有 + 补新”，线上误用等于清权限 -
attach([4, ['is_primary' => 1]])写法错误 ——attach()第二个参数是字段数组，不是混合值；正确是attach(4, ['is_primary' => 1])或attach([4 => ['is_primary' => 1]]) -
detach()传字符串 ID（如'1'）可能失效，TP8 强类型校验更严，统一用整数
所有操作建议包事务：Db::transaction(fn () => $user->roles()->sync([1, 2]));
最易被忽略的一点：TP8 的 belongsToMany 不再自动识别模型主键为 id 以外的字段。如果你的 User 主键是 uid，必须补第五、第六个参数：->belongsToMany(Role::class, 'user_role', 'user_id', 'role_id', 'uid', 'id') —— 否则关联查询会查 id = ?，永远为空。
