ThinkPHP多对多关联中间表命名须为小写+下划线+字母序拼接（如role_user），外键字段为模型名小写+_id，需显式声明belongsToMany参数及withPivot才能正确加载中间表字段。
中间表命名必须严格遵循 ThinkPHP 的默认规则
ThinkPHP 会自动推导多对多关联的中间表名，格式为「两张主表按字母序拼接」（小写+下划线），比如 User 和 Role 关联，中间表默认是 role_user，不是 user_role 或 users_roles。一旦命名不符，attach()、detach() 会静默失败或报 Table not found 错误。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 建表时直接用
php think migrate:make create_role_user_table生成迁移，并确保表名小写、无复数、按字母序排列 - 若必须用自定义表名（如
auth_assignment），在模型中显式声明：protected $pivotTable = 'auth_assignment'; - 中间表字段名也有约定：外键必须是
user_id和role_id（即「模型名小写 + _id」），不能写成uid或roleid，否则sync()会写入 0
使用 belongsToMany 时必须显式指定主键和外键
ThinkPHP 不会自动识别复合主键或非标准 ID 字段。哪怕你的 User 模型主键是 uid，Role 是 role_code，不声明就会走默认的 id，导致关联查不到数据或报 Undefined index: id。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
User模型中定义关联时，补全参数：return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id'); - 四个参数顺序固定：
模型类、中间表名、当前模型在外键字段名、关联模型在外键字段名 - 如果中间表有额外字段（如
created_at、is_primary），需调用withPivot(['is_primary'])才能在$user->roles结果里拿到这些值
sync()、attach()、detach() 的行为差异与事务安全
这三个方法都操作中间表，但语义和副作用完全不同：sync([1,2,3]) 是「最终状态」——先清空再插入；attach([4,5]) 是追加；detach([2]) 是删除指定项。混用且没包事务，极易造成数据不一致。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 批量更新权限时优先用
sync()，它底层是单条DELETE IN+ 批量INSERT，比循环attach()快且原子 - 若需记录操作人或时间戳，别依赖模型事件自动填充 —— 中间表操作绕过模型生命周期，得手动在
sync()前用Db::name('role_user')->insertAll()替代 - 涉及业务强一致性（如「用户升级 VIP 同时开通 3 个服务角色」），务必用
Db::transaction()包裹关联操作和主表更新
查询中间表字段时，withPivot 和 via 容易被忽略的细节
很多人以为 withPivot(['expired_at']) 就能让 $user->roles 返回带 expired_at 的集合，但实际上，这个字段只存在于关联对象的 pivot 属性里，即 $role->pivot->expired_at，不会合并进 $role 主体数据。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 需要连带中间表字段做条件查询时（如「查所有未过期的角色」），必须用
wherePivot()：$user->roles()->wherePivot('expired_at', '>=', time())->select() - 若中间表本身有逻辑删除（
deleted_at），belongsToMany默认不自动过滤，得手动加whereNull('role_user.deleted_at') -
via方法仅用于三级关联（如 User → Role → Permission），普通多对多不用它；误用会导致 SQL 报Unknown column 'pivot.xxx'
中间表不是透明的管道，它是有结构、有生命周期、有权限边界的实体。漏掉一个 withPivot 或写错一个外键名，后面查半天数据为空，其实只是 pivot 字段压根没加载进来。
