laravel 默认按字母顺序拼接模型名生成中间表名（如 role_user），若实际表名为 user_role，需在 belongstomany 方法中显式指定表名及外键，否则会因表不存在而报错。
laravel 默认按字母顺序拼接模型名生成中间表名（如 role_user），若实际表名为 user_role，需在 belongstomany 方法中显式指定表名及外键，否则会因表不存在而报错。
Laravel 的 Eloquent 在处理多对多关系时，**自动推导中间表（pivot table）名称遵循严格约定**：将两个关联模型的类名转换为小写蛇形命名（snake_case），按字母顺序排列，并以下划线连接。例如，`User` 和 `Role` 模型对应的默认中间表名为 `role_user`（而非 `user_role`），因为 `"role"` 在字典序上早于 `"user"`。因此，当你创建了名为 user_role 的迁移表，却未在关系定义中显式声明该表名时，Laravel 仍会按约定尝试查询 role_user，从而触发 SQLSTATE[42S02]: Base table or view not found 错误。
✅ 正确做法是在 User 或 Role 模型的 belongsToMany() 关系方法中，显式传入自定义中间表名及外键字段：
// 在 User.php 模型中
public function roles()
{
return $this->belongsToMany(Role::class, 'user_role', 'user_id', 'role_id');
}
// 在 Role.php 模型中（反向关系）
public function users()
{
return $this->belongsToMany(User::class, 'user_role', 'role_id', 'user_id');
}
⚠️ 注意事项：
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
- 第二个参数 'user_role' 是自定义中间表名；
- 第三个参数是当前模型在外键中的字段名（如 user_id）；
- 第四个参数是关联模型的外键字段名（如 role_id）；
- 若未指定后两个参数，Laravel 仍会按约定推导（如 user_id、role_id），但表名必须匹配，否则必须全部显式声明。
此外，确保 UserRole 模型（若作为独立模型使用）与关系逻辑解耦——它仅用于直接操作中间表，而 belongsToMany 关系应由 User 和 Role 模型定义，无需依赖 UserRole 模型。若误将 UserRole 用于关系定义（如 hasManyThrough），反而会引入额外复杂性。
总结：Laravel 不“猜测”你的表名偏好，而是严格执行命名约定。尊重约定可省略配置，打破约定则必须显式声明——这是 Eloquent 灵活性与可维护性的平衡设计。
