Laratrust中hasRole()校验角色返回与数据库不符如何解决

问题现象 #

开发校验用户关联角色时出现异常：数据库内ID为9的用户已关联AdminForesell角色，但打印$user->hasRole('AdminForesell')的返回结果为false，与数据库实际存储的角色关联关系不符。

问题复现代码 #

public function delete($id)
{
    $user = User::whereId($id)->first();

    dd($user->hasRole('AdminForesell'));

    if ($user->hasRole('AdminToko')) {
        File::delete('image/adminToko/logo/'. $user->store->image);
        File::delete('image/adminToko/logo/'. $user->store->banner);

        $user->store->delete();
        $user->delete();
    }
    elseif($user->hasRole('AdminForesell')) {
        Alert::error('Failed Delete', 'You cannot delete role Admin Foresell');
        return redirect('/admin-foresell/list/users');
    }
    else{
        $user->delete();

        Alert::success('Success', 'Data berhasil dihapus');
        return redirect('/admin-foresell/list/users');
    }
}

相关数据表参考 #

• roles表：
  
• role_user关联表：
  
• User用户表：
  

修复方案 #

该问题是使用spatie/laravel-permission角色权限扩展包的高频问题，核心原因是扩展包默认开启了角色权限查询缓存，直接修改数据库关联记录不会触发缓存更新，导致代码读取到的是旧缓存数据，和数据库实际值不一致，按以下步骤处理即可：

1. 重置角色权限缓存
   在项目根目录执行artisan命令清除缓存：

   php artisan permission:cache-reset
   

   执行完成后重新测试，hasRole返回值就会和数据库存储一致。
2. 校验User模型配置
   确认App\Models\User模型正确引入了扩展包提供的HasRoles特征，没有自定义覆盖角色关联逻辑、关联键配置错误：

   <?php
   
   namespace App\Models;
   
   use Illuminate\Foundation\Auth\User as Authenticatable;
   use Spatie\Permission\Traits\HasRoles; // 必须引入该trait
   
   class User extends Authenticatable
   {
       use HasRoles; // 必须在模型内使用该trait
   
       // 其余模型逻辑
   }
   

3. 核对角色名匹配规则
   检查roles表中对应角色的name字段值，确认不存在多余前后空格、大小写不一致问题，hasRole方法对角色名是严格字符串匹配。
4. 日常开发规范
   后续对角色、权限、用户角色绑定关系做增删改操作时，优先使用扩展包自带的assignRole、removeRole、syncRoles等方法，不要直接操作数据库关联表，扩展包自带方法会自动更新缓存，避免出现数据不一致问题。

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