使用Laravel Eloquent关联数据透视表时遇表不存在错误

这问题我之前也碰到过，核心原因是Laravel的belongsToMany关联默认会自动生成中间表名和关联字段，但你的实际中间表是employee_skills（不是默认的skill_user），还包含额外字段，所以必须手动指定关联参数。

问题根源拆解 #

1. 报错Base table or view not found: 1146 Table 'pfe_sirh_db.skill_user' doesn't exist：Laravel默认会把两个关联模型的小写单数名称按字母顺序拼接作为中间表名（skill + user = skill_user），但你的实际中间表是employee_skills，所以框架找不到对应的表。
2. Swagger返回"withTimestamps": false：默认情况下，belongsToMany不会自动包含中间表的时间戳字段，需要显式开启（如果你的中间表有created_at/updated_at的话）。

修改模型关联代码 #

你需要在User和Skill模型的关联方法里，手动指定中间表名、关联字段，以及包含额外字段和时间戳：

1. 修改User模型的skills关联 #

class User extends Authenticatable{
    protected $table = "users";
    
    public function skills() {
        return $this->belongsToMany(Skill::class, 'employee_skills', 'employee_id', 'skill_id')
            ->withPivot('note') // 包含中间表的额外字段note
            ->withTimestamps(); // 如果中间表有created_at/updated_at字段就添加，没有可以去掉
    }
}

参数说明：

• 第二个参数'employee_skills'：指定实际的中间表名
• 第三个参数'employee_id'：当前User模型在中间表的外键
• 第四个参数'skill_id'：关联的Skill模型在中间表的外键

2. 修改Skill模型的users关联（注意方法名改为复数，符合Laravel规范） #

class Skill extends Model {
    public function users() {
        return $this->belongsToMany(User::class, 'employee_skills', 'skill_id', 'employee_id')
            ->withPivot('note')
            ->withTimestamps();
    }
}

这里的参数顺序要反过来：当前Skill模型的外键是skill_id，关联的User模型的外键是employee_id。

3. 保留EmployeeSkill模型（可选） #

你的EmployeeSkill模型已经正确指定了表名和可填充字段，不需要修改，如果需要单独操作中间表数据（比如添加备注），这个模型可以正常使用。

验证修改 #

在tinker里重新测试：

php artisan tinker

执行以下命令：

$user = User::find(1);
$user->skills; // 现在应该会查询employee_skills表，不会再报错

关于Swagger的withTimestamps问题：添加->withTimestamps()后，返回的关联数据会包含pivot_created_at和pivot_updated_at字段（如果中间表有这些字段），此时Swagger返回的withTimestamps会变成true。

内容的提问来源于stack exchange，提问作者Hamza Zaafrane