Laravel8重命名布局为admin.blade.php仍提示layouts.app不存在如何处理

Livewire 2.x版本默认全局配置的布局路径为layouts.app，该配置独立于你自定义的AppLayout视图组件，你修改AppLayout的渲染逻辑不会覆盖Livewire内部的默认布局引用，因此会在Livewire自带的livewire-view-component.blade.php视图中抛出找不到layouts.app的错误。

以下是适配前后台多套布局的三种常用实现方式，可根据项目场景选择：

1. 单个Livewire组件单独指定布局 #

适合少量组件需要使用特殊布局的场景，直接在Livewire组件类中声明$layout属性即可：

// 后台Livewire组件示例
class AdminDashboard extends Component
{
    // 明确指定当前组件使用admin布局
    protected $layout = 'layouts.admin';

    public function render()
    {
        return view('livewire.admin.dashboard');
    }
}

2. 按路由分组全局指定布局 #

适合同路由分组下所有页面使用同一套布局的场景，可在路由定义时统一配置：

// routes/web.php
// 后台路由组
Route::prefix('admin')->middleware('auth')->group(function () {
    // 组内所有Livewire页面默认使用admin布局
    Route::get('/dashboard', \App\Http\Livewire\Admin\Dashboard::class)->layout('layouts.admin');
    Route::get('/user/manage', \App\Http\Livewire\Admin\UserManage::class)->layout('layouts.admin');
});

// 前台路由组
Route::group([], function () {
    Route::get('/', \App\Http\Livewire\Frontend\Home::class)->layout('layouts.frontend');
    Route::get('/article/list', \App\Http\Livewire\Frontend\ArticleList::class)->layout('layouts.frontend');
});

如果需要全局修改Livewire的默认布局，可先发布Livewire配置文件：
php artisan livewire:publish --config
打开生成的config/livewire.php，修改layout参数为你需要的默认布局路径即可：

// 原配置 'layout' => 'layouts.app'
'layout' => 'layouts.admin',

3. 自定义视图组件适配多场景 #

如果你基于Laravel的View Component封装了布局组件，可通过传参动态切换布局：
首先修改App/View/Components/AppLayout.php：

class AppLayout extends Component
{
    public string $layoutType;

    public function __construct(string $layoutType = 'admin')
    {
        $this->layoutType = $layoutType;
    }

    public function render()
    {
        return match($this->layoutType) {
            'admin' => view('layouts.admin'),
            'frontend' => view('layouts.frontend'),
            default => view('layouts.default'),
        };
    }
}

在blade模板中调用时传入对应参数即可：

{{-- 后台页面调用 --}}
<x-app-layout layout-type="admin">
    后台页面内容
</x-app-layout>

{{-- 前台页面调用 --}}
<x-app-layout layout-type="frontend">
    前台页面内容
</x-app-layout>

修改配置后如果开启了Laravel配置缓存，需要执行php artisan config:clear清除配置缓存后再测试。

内容的提问来源于stack exchange，提问作者mstdmstd