Laravel创建RestApi项目缺失核心文件，路由无法显示求助

1. 先明确Laravel 11与10的目录差异 #

Laravel 11做了大幅目录简化，别拿旧版本结构套：

• 不再有app/Http/Kernel.php，中间件配置移至bootstrap/app.php
• config/channels.php默认不生成，需广播功能时执行php artisan config:publish laravel/broadcasting生成
• app/Providers默认仅保留AppServiceProvider.php，其他Provider需手动创建
• routes/api.php是默认存在的，原项目缺失大概率是创建过程出错

2. 重新生成干净的Laravel项目 #

原项目文件缺失严重的话，直接重建最稳妥：

• 删除现有项目目录：rm -rf NameApp（Linux/macOS）或手动删除Windows文件夹
• 指定11稳定版创建项目：composer create-project laravel/laravel:^11.0 NameApp
• 进入项目目录：cd NameApp
• 检查核心文件：确认routes/api.php、bootstrap/app.php、app/Providers/AppServiceProvider.php存在

3. 修复路由不显示问题 #

若重建后api.php路由在route:list中不显示：

• 确保路由定义正确，示例：

  use App\Http\Controllers\SomethingController;
  Route::apiResource('something', SomethingController::class);
  

• 执行路由列表时加--api参数：php artisan route:list --api（api路由默认归api guard管理，不加参数仅显示web路由）
• 清除路由缓存后重试：php artisan route:clear

4. 处理中间件与Provider需求 #

• 中间件：用php artisan make:middleware CustomMiddleware创建，然后在bootstrap/app.php注册：

  return Application::configure(basePath: dirname(__DIR__))
      ->withMiddleware(function (Middleware $middleware) {
          $middleware->api([
              \App\Http\Middleware\CustomMiddleware::class,
          ]);
      })
      ->create();
  

• Provider：用php artisan make:provider CustomServiceProvider创建，然后在bootstrap/app.php注册：

  return Application::configure(basePath: dirname(__DIR__))
      ->withProviders([
          \App\Providers\CustomServiceProvider::class,
      ])
      ->create();
  

5. 不要手动修改composer.lock #

手动修改依赖锁文件极易导致依赖混乱，所有依赖调整通过composer require/remove或修改composer.json后执行composer update完成，比如移除非必需的sdk：composer remove preprio/laravel-rest-sdk

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