Laravel多对多关系中，若中间表名非默认role_user，需在belongsToMany()中显式传入表名；外键非标准时须指定第三、四参数；读写中间表字段需withPivot()；复杂逻辑需自定义Pivot模型并确保中间表有主键。
中间表名不叫 role_user 怎么办
Laravel 默认按字母顺序拼接模型名生成中间表，比如 User 和 Role 对应 role_user；如果实际表名是 user_roles 或 article_tag，必须显式传入第二参数，否则查不到数据或报错。
常见错误现象：SQLSTATE[42S02]: Base table or view not found: 1146 Table 'db.role_user' doesn't exist
- 在
belongsToMany()中补全表名：return $this->belongsToMany(Role::class, 'user_roles'); - 若表名含大小写（如 PostgreSQL），确保字符串完全匹配，Laravel 不做自动小写转换
- 迁移文件里建表名要和这里一致，别用
php artisan make:migration create_user_roles_table却写成create_user_role_table
外键字段不是 user_id/role_id 怎么处理
默认约定只适用于标准命名。一旦中间表外键是 author_id/category_id 这类非标准字段，不指定就会查错数据甚至静默失败。
使用场景：旧系统迁移、第三方数据库对接、团队历史命名规范不统一
- 必须传满四个参数：
belongsToMany(Role::class, 'user_roles', 'author_id', 'category_id') - 第三参数是「当前模型」在外键中的字段名（
User模型对应author_id） - 第四参数是「关联模型」在外键中的字段名（
Role模型对应category_id） - 第五、六参数可选，用于指定主键名（如主键不是
id），但极少用到
中间表有额外字段（如 is_primary、notes）怎么读写
默认 $user->roles 返回的只是 Role 实例，中间表字段根本不会加载——这不是漏了，是 Eloquent 故意设计的轻量行为。
容易踩的坑：$user->roles[0]->pivot->is_primary 直接报 Undefined property，因为没声明就访问 pivot 字段
- 先在关系里加
withPivot('is_primary', 'notes')，字段名必须和数据库列名完全一致（区分大小写） - 读取时走
$role->pivot->is_primary，别漏掉pivot层 - 写入要用
attach()或sync()传二维数组：$user->roles()->attach(2, ['is_primary' => true]) - 更新已有记录字段不能用
save()，得用updateExistingPivot(2, ['notes' => 'xxx'])
需要给中间表加业务逻辑（如自动格式化时间、验证规则）怎么办
当 withPivot() 不够用——比如要加访问器、修改器、事件监听、软删除支持，就得升格为完整模型。
关键点：自定义 Pivot 模型必须继承 Pivot，且中间表必须有主键（id 字段），否则 sync() 和 updateExistingPivot() 会失效
- 新建
app/Models/RoleUser.php，继承Illuminate\Database\Eloquent\Relations\Pivot - 在关系中用
using(RoleUser::class)替代裸withPivot() -
using()和withPivot()可共存，但withPivot()仍需保留字段声明 - 记得在两个方向的关系里都加
using()，否则反向查询（$role->users）不生效
最常被忽略的是中间表主键——没有 id 的表无法被 updateExistingPivot() 正确识别，会导致更新静默失败或重复插入。别图省事跳过这一步。
