Route[xxx] not defined 错误本质是代码中调用route('xxx')等依赖命名路由的功能时，路由注册表中缺失对应name('xxx')定义；常见原因包括漏写->name()、分组前缀未匹配、资源路由命名拼写错误或大小写不符。
Route[xxx] not defined 错误本质
这个错误不是 Laravel 找不到路由，而是你在代码里调用了 route('xxx')、redirect()->route('xxx')、或中间件里写了 auth / verified 等依赖命名路由的逻辑，但 Laravel 的路由注册表里压根没有叫 xxx 的 ->name('xxx')。
最常踩的三个坑
错误通常不出现在报错行，而出现在你“以为它存在”的地方：
- 在
web.php或api.php里漏写了->name('login')，但中间件或验证失败后跳转逻辑硬编码了route('login') - 用了路由分组（
Route::group(['as' => 'admin.'], function () { ... })），但调用时写成了route('users.index')，实际应为route('admin.users.index') - 资源路由（
Route::resource('posts', PostController::class)）默认生成的是posts.index、posts.show这类名字，但你在 Blade 里写了route('post.show', $id)（少了个s）或参数键名不匹配（比如路由是{post}，你传了['id' => 1]）
快速定位和验证方法
别猜，直接看 Laravel 实际注册了哪些名字：
- 运行
php artisan route:list --columns=method,name,uri，确认目标名字是否出现在 name 列 - 如果命令报错，说明路由文件本身有语法错误（比如用了
$this->get()而不是Route::get()），先修复路由定义 - 检查是否在
Route::middleware(...)外层包裹了未命名的路由组，导致内部->name()实际没生效 - 注意大小写和点号：Laravel 的路由名区分大小写，
Route::get('/login', ...)->name('Login')和route('login')不匹配
容易被忽略的隐性依赖
有些错误看似是 Route not defined，其实源头在别处：
-
Auth::routes()默认注册了login、register、password.request等名字 —— 如果你手动删了这行，又没补全对应路由，auth中间件就会因找不到login名而炸 - 自定义异常处理（
App\Exceptions\Handler）里重写了unauthenticated()，但没判断request()->expectsJson()就直接redirect()->route('login')，结果 API 请求也触发了该逻辑 - Blade 模板里用了
@auth+@else+<a href="https://www.php.cn/link/b9b42240909f825c24ca520d8d28255e'login')%20%7D%7D">Login</a>，但登录路由只定义在web.php，而当前请求走的是api.php路由文件（无此名）
