必须调用 Yii::$app->getAuthManager()->invalidateCache() 刷新缓存,否则 DbManager 权限变更后 can() 仍用旧快照返回 false;增删权限、分配角色、修改继承关系后均需此操作。

权限项更新后缓存不清除,会导致用户调用 Yii::$app->user->can() 时仍沿用旧权限判断,明明已加权限却返回 false。核心问题在于:Yii2 的 DbManager 不自动同步数据库变更到运行时权限图谱,必须主动干预缓存状态。
确认当前使用的是 DbManager
检查配置是否启用数据库权限管理:
-
'authManager' => ['class' => 'yii\rbac\DbManager']已在config/web.php或config/main.php中正确配置 - 确保四张表(
auth_item、auth_item_child、auth_assignment、auth_rule)已通过迁移生成:yii migrate --migrationPath=@yii/rbac/migrations - 执行
SELECT * FROM auth_item WHERE name = 'xxx';确认新增/修改的权限项确实写入数据库
手动刷新 RBAC 运行时缓存
DbManager 默认不自动重载数据,需显式调用清除方法:
- 在控制器或命令行中执行:
Yii::$app->getAuthManager()->invalidateCache(); - 若在分配权限后立即验证(如
assign()后马上can()),建议在验证前刷新,或重建 AuthManager 实例 - 开发阶段可临时禁用缓存:配置中设
'cache' => null,避免反复手动刷新
避免 assign() 后立刻 can() 失效的典型场景
以下操作顺序容易出错:
- 调用
$auth->assign($role, $userId)→ 数据写入auth_assignment表 - 紧接着执行
Yii::$app->user->can('somePermission')→ 此时权限图谱未更新,仍查不到新关系 - 解决办法:要么先
invalidateCache(),要么让用户重新登录(触发新请求生命周期加载最新权限)
补充:权限项增删也要注意缓存影响
使用 addPermission() 或 removeChild() 等操作后,同样需要刷新缓存才能生效:
-
createPermission()只是新建对象,不入库;addPermission()才真正写库并参与权限计算 - 角色继承关系(
addChild())变更后,也必须调用invalidateCache(),否则父子链路不会被重新解析 - 不要依赖“改完就立刻生效”,RBAC 图谱是构建在内存中的快照,不是实时 SQL 查询











