Laravel中User模型MorphToMany关联Permissions为空的原因排查

核心问题 #

你自定义的permissions()关联未匹配Spatie库的中间表结构要求，导致查询时无法正确关联到权限数据。

具体原因与修复方案 #

方案1：直接使用Spatie自带的Trait（推荐） #

Spatie的laravel-permission库已经为模型实现了完整的权限关联逻辑，无需手动定义MorphToMany关联。只需在User模型中引入HasPermissions trait即可：

use Spatie\Permission\Traits\HasPermissions;

class User extends Model
{
    use HasPermissions;

    // 其他模型代码...
}

引入后，原有的with('permissions')查询会自动正常工作，无需修改查询代码。

方案2：修正自定义关联的参数（不推荐） #

如果坚持手动定义关联，需明确指定中间表的关联键（Spatie中间表使用permission_id作为权限的外键，而非默认的id），同时确保model_type匹配模型的形态类：

public function permissions(): MorphToMany
{
    return $this->morphToMany(
        Permission::class,
        'model',
        'model_has_permissions',
        'model_id',
        'permission_id' // 显式指定权限在中间表的外键
    );
}

另外需确认model_has_permissions表中model_type字段的值与User模型getMorphClass()方法的返回值一致（默认是完整类名如App\Models\User），若表中存储的是短类名（如User），需在模型中重写该方法：

public function getMorphClass()
{
    return 'User';
}

内容的提问来源于stack exchange，提问作者Petro Gromovo