Laravel项目路由突然失效，执行php artisan route:list无路由显示

1. 清理缓存 #

卸载第三方包后缓存可能残留异常，先执行以下命令清除缓存：

• php artisan route:clear（清除路由缓存）
• php artisan config:clear（清除配置缓存）
  执行完成后重新运行php artisan route:list查看结果。

2. 修复Composer自动加载 #

卸载包后自动加载映射可能失效，重新生成：

composer dump-autoload

3. 检查控制器命名与导入 #

确认web.php中使用的控制器类：

• 顶部是否正确导入控制器，例如：

  use App\Http\Controllers\IndexController;
  use App\Http\Controllers\ContactController;
  use App\Http\Controllers\VolunteerController;
  use App\Http\Controllers\NewController;
  

• 如果未导入，需使用完整命名空间，例如：

  Route::get('/', [App\Http\Controllers\IndexController::class, 'index'])->name('index');
  

• 同时确认控制器文件存在于app/Http/Controllers目录下，文件名与类名一致（遵循PSR-4规范，注意大小写）。

4. 移除残留的包配置 #

由于卸载了maatwebsite/excel，检查config/app.php文件：

• 移除providers数组中可能残留的Maatwebsite\Excel\ExcelServiceProvider::class
• 移除aliases数组中可能残留的'Excel' => Maatwebsite\Excel\Facades\Excel::class
  修改后执行php artisan config:clear生效。

5. 排查语法或运行时错误 #

如果以上步骤无效，查看Laravel日志文件storage/logs/laravel.log，查找路由加载过程中的报错信息，常见问题包括：

• 其他文件的语法错误导致路由加载中断
• 依赖包缺失或版本冲突

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