ThinkPHP 6.x 中没有 _belongsToMany 这个方法名，写它就直接失效——要么报 Call to undefined method belongsToMany()，要么静默返回空集合。必须用纯驼峰 belongsToMany，且参数一个都不能少、一个都不能错。
belongsToMany 方法名和参数顺序不能错
常见错误是把方法写成 _belongsToMany 或 belongToMany，框架根本识别不了，关联就断了。正确签名是：
belongsToMany(关联模型类, 中间表名, 当前模型外键, 关联模型外键, 当前主键, 关联主键)
6 个参数必须全显式传，哪怕都是 id 也得写两次。例如：
立即学习“PHP免费学习笔记（深入）”；
public function roles(){ return $this->belongsToMany(Role::class, ‘sys_user_role’, ‘uid’, ‘rid’, ‘id’, ‘id’);}第 2 个参数 ‘sys_user_role’ 是中间表名（不含数据库前缀）第 3 个参数 ‘uid’ 是当前模型（如 User）在中间表里的字段名，必须和数据库字段完全一致（区分大小写）第 4 个参数 ‘rid’ 是关联模型（如 Role）在中间表里的字段名第 5/6 个参数默认是 ‘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 实例，中间表字段（比如分配时间、状态、排序）压根不会加载进来。想访问 $role->pivot->created_at，必须走中间模型路径。
先建中间模型（如 UserRole），继承 think\Model，并指定表名：
namespace app\model;use think\Model;<p>class UserRole extends Model{protected $name = ‘sys_user_role’;}
再在 User 模型中改写关联：
public function roles(){ return $this->belongsToMany(Role::class) ->through(UserRole::class);}中间模型类名必须传完整命名空间或字符串，如 UserRole::class中间模型里不需要定义关联方法，只要表名对、主键对即可此时 $user->roles 返回的每个 Role 对象都会带 pivot 属性，里面是 UserRole 表的整行数据
with 闭包里加 where 容易覆盖原始查询条件
给多对多预加载加筛选条件时，不能直接在闭包里用 $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(…) 会覆盖 pivot 的 IN 查询逻辑，SQL 里只剩单个 = 条件字段别名注意：关联表字段需带表别名，如 ‘roles.status’，不是 ‘role.status’
最常被忽略的是 getRelation 方法在 TP6.0.7 版本存在 pivot 数据丢失 bug，如果发现 $role->pivot 是空数组，优先检查是否用了该版本——临时方案是替换 vendor/topthink/think-orm/src/model/relation/BelongsToMany.php 中的 getRelation 方法为 6.0.3 的实现。
评论(0)