ThinkPHP6.0多对多关联_ThinkPHP6.0belongsToMany配置【模型】

ThinkPHP 6.x 多对多关联必须用 belongsToMany 而非 _belongsToMany 或 belongToMany，且需显式传全6个参数：关联模型类、中间表名、当前模型外键、关联模型外键、当前主键、关联主键；中间表字段需建中间模型并通过 through 指定才能访问 pivot 数据。

在ThinkPHP 6.x里配置多对多关联，方法名和参数顺序是绝对马虎不得的。一个字母写错，或者参数少传一个，整个关联就失效了。更让人头疼的是，框架可能连个像样的错误都不报，直接给你返回一个空集合，排查起来相当费劲。

belongsToMany 方法名和参数顺序不能错

首先，方法名必须严格写成 belongsToMany。写成 _belongsToMany 或者 belongToMany 都是无效的，框架根本认不出来，关联自然就断了。

正确的签名格式是：

belongsToMany(关联模型类, 中间表名, 当前模型外键, 关联模型外键, 当前主键, 关联主键)

这6个参数必须全部显式传递，哪怕你的主键和外键都叫 id，也得老老实实写两遍。来看一个标准的例子：

public function roles(){
    return $this->belongsToMany(Role::class, 'sys_user_role', 'uid', 'rid', 'id', 'id');
}

• 第二个参数 'sys_user_role' 指的是中间表的表名，注意这里不需要带数据库前缀。
• 第三个参数 'uid' 是当前模型（比如User）在中间表里对应的字段名，必须和数据库里的字段名完全一致，包括大小写。
• 第四个参数 'rid' 是关联模型（比如Role）在中间表里的字段名。
• 第五和第六个参数默认是 'id'，但如果你的主键不是 id，比如叫 user_id 或 role_code，这里就必须对应修改。

中间表字段不匹配时查不到数据但不报错

ThinkPHP默认遵循一些约定，比如它会按字母顺序拼接表名（生成类似 role_user 这样的表名），并假设外键是 user_id 和 role_id。如果你的数据库设计不遵循这些约定，比如中间表叫 sys_user_role，字段用的是 uid 和 rid，而你又没在 belongsToMany 里声明，那框架就会去查一个根本不存在的表。结果就是数据为空，而且调试日志里可能连一条相关的SQL语句都找不到。

怎么验证呢？打开调试模式，看看日志里有没有类似 SELECT * FROM `sys_user_role` WHERE `uid` = ? 的查询。如果没有，那基本可以断定是参数没对上。

• 最稳妥的做法就是永远显式传递全部6个参数，别依赖框架的默认约定。
• 如果你的中间表名在数据库里是带前缀的（比如 tp_sys_user_role），那么在 belongsToMany 里第二个参数只填 'sys_user_role' 即可，表前缀由数据库配置文件统一管理。
• 字段名的大小写问题也要注意，MySQL在某些配置下是严格区分大小写的。

要读中间表字段（如 created_at、status）必须建中间模型 + through

光靠 belongsToMany 方法，你只能拿到关联的模型实例（比如Role），中间表里的额外字段（比如分配时间 created_at、状态 status、排序 sort）是不会被加载进来的。如果你想访问 $role->pivot->created_at，就必须通过中间模型来实现。

首先，需要创建一个中间模型（比如叫 UserRole），继承 think\Model，并指定表名：

namespace app\model;
use think\Model;
class UserRole extends Model{
    protected $name = 'sys_user_role';
}

然后，在User模型中改写关联方法：

public function roles(){
    return $this->belongsToMany(Role::class)
                ->through(UserRole::class);
}

• 中间模型的类名需要传递完整的命名空间，或者使用 ::class 语法。
• 中间模型本身不需要定义复杂的关联方法，只要表名和主键配置正确就行。
• 配置之后，通过 $user->roles 获取的每个 Role 对象都会附带一个 pivot 属性，里面包含了中间表（UserRole）对应行的所有数据。

with 闭包里加 where 容易覆盖原始查询条件

在给多对多关联进行预加载（with）并附加筛选条件时，有个常见的坑。你不能直接在闭包里使用 $query->where(...)，因为这会覆盖掉框架为关联查询自动生成的 IN 条件，导致最终可能只查出一条记录，甚至什么都查不到。

正确的做法是，先获取底层的查询对象，再添加条件：

$data = User::where('status', 1)
    ->with(['roles' => function ($query) {
        $query->getQuery()->where('roles.status', 1)->order('sort desc');
    }])
    ->select();

• 关键点在于使用 $query->getQuery() 来获取底层的 Query 对象，然后在这个对象上调用 where 和 order 方法。
• 如果直接写 $query->where(...)，会破坏掉关联查询中用于匹配中间表记录的 IN 逻辑，SQL语句里可能只剩下一个简单的等值条件。
• 另外要注意字段别名，关联表的字段需要带上表别名，比如 'roles.status'，而不是 'role.status'。

最后提一个版本相关的细节。在ThinkPHP 6.0.7版本中，getRelation 方法存在一个可能导致 pivot 数据丢失的bug。如果你发现通过关联获取到的 $role->pivot 是空数组，可以先检查一下框架版本。临时的解决方案是，将 vendor/topthink/think-orm/src/model/relation/BelongsToMany.php 文件中的 getRelation 方法替换为6.0.3版本的实现。