Laravel 8 使用 Jetstream 导航菜单时路由未定义问题如何解决

问题原因 #

你的报错核心是路由命名和模板中调用的路由名不匹配，同时存在资源路由使用错误、路由缓存未清理的问题，具体对应你几次修改的错误点如下：

1. 初始单GET路由阶段：你给/accounts路径设置的路由名称是accounts，但模板中调用了route('accounts.index')，自然找不到对应命名路由
2. 第一次修改为资源路由的错误：Route::resource()的第二个参数需直接传入控制器类名，你传入[AccountController::class, 'index']属于语法错误，资源路由会自动映射控制器的7个预设方法，无需单独指定方法
3. 第二次修改资源路由的错误：用->name('index', 'accounts')修改资源路由命名的语法错误，若要覆盖资源路由的默认命名，需传入数组格式->names(['index' => 'accounts'])，无特殊需求直接用资源路由默认生成的命名即可
4. 最容易遗漏的点：Laravel的路由缓存机制会缓存路由名称映射，你直接访问URL能正常打开是因为走了路由路径匹配，但route()辅助函数会优先读取缓存的路由命名表，修改路由后未清理缓存就会出现路径可访问、路由名找不到的情况

解决方案 #

按以下步骤操作即可修复：

1. 修正路由配置：将web.php中accounts相关路由改为正确的资源路由写法，无需额外自定义命名，资源路由会自动生成accounts.index/accounts.create等标准命名：

Route::middleware(['auth:sanctum', 'verified'])
    ->resource('/accounts', AccountController::class)
    ->only(['index', 'create', 'store', 'update']);

2. 修正导航栏模板调用：修改navigation-menu.blade.php中的导航项代码，匹配默认生成的路由名，同时用accounts.*匹配所有账户相关路由，让导航项在所有账户页面都保持激活状态：

<div class="hidden space-x-8 sm:-my-px sm:ml-10 sm:flex">
    <x-jet-nav-link href="{{ route('accounts.index') }}" :active="request()->routeIs('accounts.*')">
        {{ __('Accounts') }}
    </x-jet-nav-link>
</div>

3. 清理路由缓存：在项目根目录执行以下Artisan命令清理旧的路由缓存：
   php artisan route:clear
   如果是生产环境，清理后可执行php artisan route:cache重新生成缓存。

4. 可选校验：执行php artisan route:list命令查看所有已注册的路由，确认accounts.index路由和对应名称存在即可。

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