belongsToMany方法名必须为纯驼峰且显式传6个参数，写错成_belongToMany会导致关联失效；中间表字段名须完全匹配；含业务字段需建中间模型并通过through指定；多表操作必须用Db::transaction包裹。
belongsToMany 方法名写错，关联直接失效
ThinkPHP 6.x 没有 _belongsToMany 这个方法，这是最常踩的坑。写成 _belongsToMany 后调用 $user->roles 会报 Call to undefined method belongsToMany() 或静默返回空集合——因为框架根本没识别到这个方法。
正确写法是纯驼峰：belongsToMany，且必须显式传参，不能只靠约定：
-
Role::class：关联模型类 -
'sys_user_role'：中间表名（不含数据库前缀） -
'uid'：当前模型（User）在中间表的外键字段 -
'rid'：关联模型（Role）在中间表的外键字段 -
'id'和'id'：两个模型各自的主键名（哪怕都是id也得写全）
示例：
public function roles()
{
return $this->belongsToMany(Role::class, 'sys_user_role', 'uid', 'rid', 'id', 'id');
}中间表字段或命名不匹配，查不到数据但不报错
ThinkPHP 默认按字母顺序拼接表名（role_user），并假设外键是 user_id 和 role_id。一旦你的中间表叫 sys_user_role、字段是 uid/rid，又没在 belongsToMany 里声明，框架就会去查一个不存在的 role_user 表，结果为空——连 SQL 都没发出去，自然没错误提示。
立即学习“PHP免费学习笔记（深入）”；
验证方式很简单：打开调试模式，看日志里有没有生成类似 SELECT * FROM `sys_user_role` WHERE `uid` = ? 的语句。没有，说明参数没对上。
建议做法：
- 永远显式传全部 6 个参数，别省略
- 中间表字段名必须和数据库实际字段完全一致（区分大小写）
- 如果中间表带前缀（如
tp_sys_user_role），belongsToMany第二个参数只填sys_user_role，前缀由数据库配置统一管理
要存中间关系字段？必须建中间模型 + through
如果中间表里有 created_at、status、sort 这类业务字段，光靠 belongsToMany 是读不到的——它只返回关联的 Role 实例，不带中间行数据。
这时必须单独建一个中间模型（比如 UserRole），并在关联方法里用 through 显式指定：
public function roles()
{
return $this->belongsToMany(Role::class)
->through(UserRole::class);
}此时 $user->roles 返回的每个 Role 对象会多一个 pivot 属性，里面包含 UserRole 表的所有字段值（如 $role->pivot->created_at）。
注意：UserRole 模型必须继承 Model，且需定义 protected $table = 'sys_user_role';，否则 pivot 数据为空。
多表操作涉及中间表时，事务必须用 Db::transaction
关联写入（比如给用户批量赋角色）本质是往中间表插入多条记录。如果中间表操作失败一半，会导致数据不一致。ThinkPHP 不支持在模型关联方法里自动包裹事务，必须手动控制。
推荐用 Db::transaction 匿名函数方式，它会自动 commit/rollback，不用手写 try-catch：
use think\facade\Db;
<p>Db::transaction(function () use ($userId, $roleIds) {
// 先清空旧关系
Db::name('sys_user_role')->where('uid', $userId)->delete();
// 再批量插入新关系
$data = array_map(function($rid) use ($userId) {
return ['uid' => $userId, 'rid' => $rid];
}, $roleIds);
Db::name('sys_user_role')->insertAll($data);
});关键点：
- 不要用多个
M()或不同模型实例开启事务，它们彼此隔离 - 中间表操作尽量走
Db::name()，避免模型层额外逻辑干扰 - 如果同时更新主表（如 User）和中间表，把所有操作放进同一个
Db::transaction闭包里
中间表字段多、业务逻辑重的时候，最容易漏掉事务包裹——看起来只是“加个角色”，实则可能破坏权限一致性。
