Laravel从4.2升级至5.6运行composer install时遇类不存在错误

问题描述 #

升级Laravel从4.2到5.6后执行composer install时触发PHP致命错误：

PHP Fatal error: Uncaught ReflectionException: Class App\Console\Kernel does not exist in /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php:788
Stack trace:
#0 /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(788): ReflectionClass->__construct('App\Console\Ker...')
#1 /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(667): Illuminate\Container\Container->build('App\Console\Ker...')
#2 /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(265): Illuminate\Container\Container->resolve('App\Console\Ker...', Array, false)
#3 /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(785): Illuminate\Container\Container->Illuminate\Container{closure}(Object(Illuminate\Foundation\Application), Array)
#4 /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(667): Illuminate\Container\Container- in /home/ubuntu/fusion/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php on line 788

当前composer.json配置：

"require": {
    "php": "^7.1.3",
    "fideloper/proxy": "^4.0",
    "laravel/framework": "5.8.*",
    "laravel/tinker": "^1.0"
},
"require-dev": {
    "filp/whoops": "^2.0",
    "fzaninotto/faker": "^1.4",
    "mockery/mockery": "^1.0",
    "nunomaduro/collision": "^2.0",
    "phpunit/phpunit": "^7.0"
}

解决方案 #

• 检查并添加App\Console\Kernel文件
  Laravel 5.x开始引入App\Console\Kernel.php文件，而4.2版本无此结构。确认项目根目录下app/Console/Kernel.php是否存在，若缺失，创建该文件并写入基础内容：

  <?php
  
  namespace App\Console;
  
  use Illuminate\Console\Scheduling\Schedule;
  use Illuminate\Foundation\Console\Kernel as ConsoleKernel;
  
  class Kernel extends ConsoleKernel
  {
      protected $commands = [
          // 可在此注册自定义命令
      ];
  
      protected function schedule(Schedule $schedule)
      {
          // 定义任务调度，示例：$schedule->command('inspire')->hourly();
      }
  
      protected function commands()
      {
          $this->load(__DIR__.'/Commands');
          require base_path('routes/console.php');
      }
  }
  

• 修正Laravel版本一致性
  配置中指定的Laravel版本为5.8.*，但升级目标是5.6，版本不匹配会导致依赖与结构冲突。将laravel/framework版本改为5.6.*，执行命令更新依赖：

  composer update laravel/framework --with-dependencies
  

• 清理缓存并重新安装
  执行以下命令清理Composer缓存，避免旧依赖干扰：

  composer clear-cache
  composer dump-autoload
  composer install
  

• 确认目录与命名空间规范
  确保app/Console目录命名空间为App\Console，Linux环境下注意区分大小写，目录结构需符合Laravel 5.x规范。

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