DbManager 初始化失败：表不存在或连接没生效
直接跑 yii migrate –migrationPath=@yii/rbac/migrations 会报错，常见原因是数据库还没连上、或者 migration 表本身缺失。不是迁移脚本有问题，而是 Yii2 的 DbManager 默认依赖 auth_assignment、auth_item、auth_item_child、auth_rule 这四张表，必须先建好才能用。
确保 config/web.php 或 config/main.php 中 ‘authManager’ 配置已启用且指向 DbManager，例如：’authManager’ => [ ‘class’ => ‘yii\rbac\DbManager’, ‘defaultRoles’ => [‘guest’],],手动检查数据库里是否真有这四张表；没有就别硬跑 migrate，先确认 db 组件配置正确（尤其 dsn 和 username/password）如果用的是 MySQL 8+，注意默认字符集是 utf8mb4，而 Yii2 RBAC 迁移脚本建表时没显式指定，可能触发 Specified key was too long 错误；临时解决是在迁移前执行：ALTER DATABASE `your_db_name` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
角色/权限加不进去：addRole() 返回 false 却没报错
调用 $auth->addRole($role) 没报错但查不到数据，大概率是事务没提交，或者对象没刷新。DbManager 内部用的是缓存 + 数据库双写，但默认不自动 flush。
确认 $auth 是从容器里取的实例：$auth = Yii::$app->authManager;而不是 new 出来的加完角色后立刻查，要先调 $auth->invalidateCache()，否则可能读到旧缓存如果在 console 命令里操作，记得加 Yii::$app->end(); 或显式 exit，避免 CLI 环境下某些钩子没触发导致写入延迟权限名（$permission->name）不能含空格、点号、斜杠，只支持字母、数字、下划线、连字符；比如 post.create 会静默失败
assign() 不生效：用户登录后 still can’t access
$auth->assign($role, $userId) 执行成功，但 Yii::$app->user->can(‘xxx’) 仍返回 false，问题通常出在用户 ID 类型或 session 缓存上。
$userId 必须是整数（int），哪怕数据库里是字符串类型，DbManager 也会强转；传字符串如 ‘123’ 会导致插入 auth_assignment 表时 user_id 字段为 0检查 User::identityClass 对应的模型里，是否实现了 getId() 方法并返回 int 类型值RBAC 权限检查默认走缓存，如果刚 assign 就测，加一句 Yii::$app->user->identity->getAuthKey() 强制重载用户身份，或清 session：Yii::$app->session->remove(‘auth_roles’);注意：只有登录态用户才能用 Yii::$app->user->can()；未登录时该方法始终返回 false，和权限配置无关
规则（Rule）里 getRolesByUser() 被忽略
自定义 Rule 类写了 execute()，也绑给了 Permission，但权限判断完全不走这个函数——因为 Rule 只在带参数的 can() 调用中触发，比如 Yii::$app->user->can(‘updatePost’, [‘post’ => $post])，纯字符串检查不会进 Rule。
Rule 的 $params 参数必须是非空数组，且键名需与 execute() 方法签名一致；例如：public function execute($user, $item, $params){ return isset($params[‘post’]) && $params[‘post’]->createdBy == $user;}绑定 Rule 到 Permission 时，必须用 $auth->add($rule) 先存 rule，再赋给 permission 的 $permission->ruleName 属性，最后 $auth->add($permission)Rule 类文件路径要能被自动加载；放在 @app/rbac/ 下记得在 composer.json 加 autoload mapping，否则类找不到，assign 会静默跳过DbManager 的坑不在逻辑复杂，而在每个环节都依赖“状态一致”：数据库表、缓存、用户 ID 类型、参数传递方式、类自动加载路径……少对一环，can() 就返回 false，还很难定位。
评论(0)