Yii2 RBAC 初始化失败主因是数据库未连通或auth_四表缺失，需先确保DbManager配置正确、DB组件可用，并处理MySQL 8+字符集问题；角色添加后需调invalidateCache()刷新缓存；assign()要求$userId为int类型且用户已登录；Rule仅在带$params的can()中触发。

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。

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

• 确认 $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，还很难定位。