thinkphp 6.x 多对多关联必须用 belongstomany 而非 _belongstomany 或 belongtomany，且需显式传全6个参数：关联模型类、中间表名、当前模型外键、关联模型外键、当前主键、关联主键；中间表字段需建中间模型并通过 through 指定才能访问 pivot 数据。
ThinkPHP 6.x 中没有 _belongsToMany 这个方法名，写它就直接失效——要么报 Call to undefined method belongsToMany()，要么静默返回空集合。必须用纯驼峰 belongsToMany，且参数一个都不能少、一个都不能错。
belongsToMany 方法名和参数顺序不能错
常见错误是把方法写成 _belongsToMany 或 belongToMany，框架根本识别不了，关联就断了。正确签名是：
belongsToMany(关联模型类, 中间表名, 当前模型外键, 关联模型外键, 当前主键, 关联主键)
6 个参数必须全显式传，哪怕都是 id 也得写两次。例如：
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';
}</p>
再在 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 的实现。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
