RBAC在Yii2中配置的关键是确保四张表生成、路由刷新、Rule正确注册及菜单使用MenuHelper过滤；缺一不可，否则权限逻辑静默失效。
不难，但容易卡在几个具体环节上——表没建、路由没刷、Rule写错、菜单没关联。只要避开这几个点，RBAC在 Yii2 里就是配置 + 几次点击 + 一两段代码的事。
DbManager 表没生成就跑权限逻辑？直接报错
所有基于数据库的 RBAC 操作（assign、addChild、can）都会因缺少四张核心表而抛出 SQLSTATE[42S02]: Base table or view not found 错误。这不是代码写错了，是环境根本没准备好。
- 必须先执行迁移命令：
yii migrate --migrationPath=@yii/rbac/migrations - 如果用了非默认 DB 组件（比如叫
mainDb），得加--db=mainDb参数，否则表建在 default 连接上，而你的authManager指向的是另一个库 - 迁移后手动查库：确认存在
auth_item、auth_item_child、auth_assignment、auth_rule四张表，缺一张都不行 -
authManager组件配置里不能只写'class' => 'yii\rbac\DbManager'，还得确保'db' => 'db'（或对应组件名）已正确注入，否则它连不到你刚建的表
/admin/route/index 刷不出来路由？权限系统就卡死
后台菜单、权限分配、角色绑定全依赖路由列表。如果 /admin/route/index 页面左侧空空如也，或者 /user/*、/post/update 这类路由根本没出现，后面所有操作都白搭。
- 确保控制器方法是 public 且没加
private或protected修饰符；RBAC 只扫描 public action - 检查是否启用了 URL 美化（
enablePrettyUrl），如果开了但没配 Web 服务器重写规则，部分路由可能无法被识别 - 刷新按钮必须点——它不是 UI 装饰，而是真正调用
yii\rbac\DbManager::getRoutes()去扫描并写入auth_item表，不点就不会入库 - Gii 生成的 CRUD 控制器默认带
behaviors()，若里面写了AccessControl且规则太严（比如限制了@登录态但当前用户未登录），会导致路由扫描失败
Rule 类 execute() 返回 false 却没报错？其实是被绕过了
auth_rule 表里存的是 Rule 类名，但真正起作用的是类里 execute() 方法的返回值。很多人写了 Rule 却发现没生效，问题往往不在逻辑，而在注册方式。
- Rule 类必须继承
yii\rbac\Rule，且$name属性值要和后台/admin/rule/index新增时填的“名称”完全一致（大小写敏感） - 新增 Rule 时，“类名”字段必须填完整命名空间，比如
backend\components\ArticleRule，漏掉backend\components\就加载失败 - 给权限项（
auth_item.type = 2）绑定 Rule 时，必须在auth_item.rule_name字段写入该 Rule 的$name，而不是类名 -
execute()方法里别用die或exit，RBAC 会静默捕获异常并当返回false处理；调试时建议用Yii::debug()打点，确认是否真的进了这个方法
菜单不显示？不是权限没配，是没走 MenuHelper
即使用户有 /user/index 权限，Menu::widget() 也不会自动过滤掉无权菜单——它默认展示全部。必须显式调用带权限过滤的辅助方法。
- 菜单渲染不能直接传静态数组，得用
MenuHelper::getAssignedMenu(Yii::$app->user->id)，这个方法会查auth_assignment+auth_item_child+ 自定义菜单表（如auth_item_menu）做递归权限匹配 - 如果用了第三方扩展（比如
mdm-admin），它的MenuHelper默认只读auth_item中type = 1（角色）的记录，但菜单节点通常设为type = 2（权限），需改写getAssignedMenu()的查询条件 - 菜单表（如
menu或auth_item_menu）里的route字段必须和auth_item.name完全一致，包括斜杠方向和通配符写法（/user/*≠user/*）
最难的部分从来不是写 Rule 或 assign 用户，而是搞清每个环节的数据落点：路由扫进哪张表、权限绑到哪个字段、菜单从哪张表查、Rule 名怎么对上号。一旦数据链路断在某一处，整个权限流就静默失效，还很难 debug。
