laravel-adminlte三级菜单需手动构造children数组结构并确保键名为'children'且值为非空数组，blade模板需递归支持或改用扁平化配置，路由命名须带层级前缀并用route()生成url，修改后需清除config和view缓存。
菜单层级错位不是样式问题，而是数据结构或渲染逻辑没对齐。Laravel-AdminLTE 默认只支持两级菜单（主菜单 + 子项），三级及以上必须手动构造结构、显式控制嵌套层级，不能依赖自动展开。
菜单数组必须带明确 children 字段
AdminLTE 的菜单渲染器会检查每个菜单项是否含 children 键，且该值必须是数组（哪怕为空）。若用对象、Collection 或 null，就会跳过渲染子级，导致“看起来少了一层”。
- ✅ 正确写法：
'children' => [['text' => '权限管理', 'url' => '/admin/roles']] - ❌ 错误写法：
'children' => $rolesCollection（未 toArray()）、'children' => null、'sub' => [...]（键名不对） - 建议统一用
->map(...)->values()->toArray()保证格式干净，避免空 children 被过滤
Blade 模板需启用递归组件或手动展开三级
默认的 @include('adminlte::partials.sidebar.menu-item') 只递归两层。要支持三级，要么改写 menu-item，要么在配置中传入已完全展开的扁平结构。
- 推荐做法：在
config/adminlte.php的menu配置里，直接返回三级完整数组，不依赖运行时递归 - 若用自定义 Blade 组件，确保内部有类似
@foreach($item['children'] ?? [] as $sub)→ 再套一层@foreach($sub['children'] ?? [] as $third) - 别在模板里调用
$item->children—— AdminLTE 不识别 Eloquent 关系，只认数组结构
路由参数与 URL 生成必须匹配层级路径
三级菜单常对应类似 /admin/system/roles 这样的 URI，但 route() 辅助函数若没传全参数，或命名不规范，会导致 active 状态错判、高亮错位。
- 确认路由名带层级前缀，如
admin.system.roles.index，而非简单roles.index - 菜单项的
'url'建议用route('admin.system.roles.index')而非硬编码，避免路径变动时失效 - active 判断依赖 URL 匹配，若三级菜单 URL 是
/admin/system/roles，则'active' => request()->is('admin/system/*')才能正确命中
缓存与配置更新不同步
修改菜单后页面没变化，大概率是 Laravel 缓存了 config 或视图，导致旧结构还在渲染。
- 执行
php artisan config:clear和php artisan view:clear - 如果用了
php artisan adminlte:install --force，确认它没覆盖你自定义的 menu 配置 - 检查
config/adminlte.php是否被缓存读取——可临时加dd(config('adminlte.menu'))验证实际加载内容
