AdminLTE在Yii2后台集成失败主因是views路径覆盖不全、as access拦截配置错误或路由权限未预热；需确保backend/views下含left.php等完整布局文件，allowActions配admin/*，并确认菜单数据由Menu::getItems()动态加载。
AdminLTE 在 Yii2 后台集成失败，大概率不是模板本身的问题，而是 views 覆盖路径、as access 拦截逻辑、或路由权限未预热这三处没对齐。直接按标准流程走，90% 的“样式不生效”“菜单不显示”“404/500 刷屏”都能当场解决。
复制 views 时必须覆盖 backend/views/layouts 和 site
很多人只复制了 layouts，漏掉 site，结果登录页是 AdminLTE 样式，但首页还是默认白板；或者反过来，首页有菜单但登录框错位。这是因为 AdminLTE 的 left.php（侧边栏）、main.php（主布局）、login.php（登录页）分散在两个目录里。
- 来源路径一定是：
vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app/ - 目标路径必须是：
backend/views/（不是views/或frontend/views/） - 复制后检查：
backend/views/layouts/left.php文件是否存在且内容含AdminLTE字样（搜索sidebar-menu或skin-blue可快速验证） - 如果用的是
yii2-adminlte3（hail812 版），路径略有不同：vendor/hail812/yii2-adminlte3/example-views/yiisoft/yii2-app/，别混用
as access 配置错误会导致菜单空白或无限重定向
启用 mdmsoft/yii2-admin 后，as access 组件会拦截所有未授权请求。但如果配置里漏写了 admin/* 或写成 admin/（少一个星号），就会导致 /admin/menu 进不去、/admin/route 403、甚至整个左侧菜单渲染为空 —— 因为菜单数据是通过 admin/menu 接口动态加载的，接口被拦，前端就收不到任何菜单项。
- 正确写法：
'allowActions' => ['site/*', 'admin/*']（注意末尾的*） - 临时调试时可设为
['*']，但上线前必须删掉或收紧 - 如果已配置但仍 403，检查是否在
backend/config/main.php中重复定义了as access—— 多个同名行为会互相覆盖 - 还有一种常见情况：用户没分配任何角色，
authManager返回空权限，菜单自然为空。用admin用户测试前，先确保它绑定了/*权限
菜单不显示？先确认 left.php 是否读取了真实菜单数据
AdminLTE 的侧边栏不是静态 HTML，而是靠 PHP 循环 $menuItems 渲染的。这个变量来自 mdm\admin\components\Menu::getItems()，底层依赖 authManager 查询数据库。如果菜单列表页面能打开但侧边栏空白，说明数据没传进来。
- 打开
backend/views/layouts/left.php，找到类似foreach ($menuItems as $item)的循环，确认上面有没有use mdm\admin\components\Menu;或$menuItems = Menu::getItems(); - 如果用了旧版拷贝（比如从
yii2-app-basic复制的），里面可能压根没调Menu::getItems()，而是写死的数组，这种必须手动替换 - 检查数据库表
auth_item和auth_item_child是否有你添加的菜单路由（如/admin/role/index），没有就说明/admin/route页面没点“刷新”或“同步”按钮 - 路由缓存也可能干扰：执行
php yii cache/flush-schema或清空@runtime/cache/目录再试
最常被忽略的一点：AdminLTE 的 left.php 默认只渲染一级和二级菜单，如果你加了三级菜单（比如“角色 → 权限 → 分配”），但没在 Menu::getItems() 的递归逻辑里放开深度限制，它就不会显示。这不是 bug，是设计如此 —— 真实项目中三级以上菜单体验差，建议用 Tab 或 Modal 替代。
