运行Laravel项目php artisan命令提示HelloVideo\Console\Kernel类不存在怎么解决

问题根源 #

报错提示找不到HelloVideo\Console\Kernel类，而你当前composer.json的PSR-4自动加载规则是将App\命名空间映射到app/目录，说明原项目之前把默认的命名空间从App改成了HelloVideo，后续修改不完整或者项目迁移时丢失了对应配置，导致自动加载无法匹配到Kernel类。
注意：Kernel是artisan命令的入口依赖类，缺失后所有artisan命令都会报错，不要尝试运行php artisan clear-compiled这类命令，直接手动删除缓存文件即可

排查步骤 #

• 检查app/Console/目录下是否存在Kernel.php文件，打开文件确认顶部的命名空间声明：如果是原项目自定义命名空间，应该为namespace HelloVideo\Console;，Laravel默认配置则为namespace App\Console;
• 检查bootstrap/app.php文件中Console Kernel的绑定代码，确认引用的命名空间：
  查找如下代码段：

  $app->singleton(
      Illuminate\Contracts\Console\Kernel::class,
      // 此处配置为HelloVideo\Console\Kernel::class 还是 App\Console\Kernel::class
  );
  

• 核对composer.json的autoload.psr-4配置是否和实际使用的命名空间匹配。

解决方案 #

根据你的需求选择对应方案即可：

方案1：保留原项目的HelloVideo命名空间（推荐，无需修改业务代码） #

1. 修改composer.json的autoload.psr-4配置，将"App\\": "app/"替换为"HelloVideo\\": "app/"
2. 手动删除bootstrap/cache目录下的所有缓存文件：
   rm -rf bootstrap/cache/*
3. 重新生成自动加载文件：
   composer dump-autoload
4. 测试artisan命令是否恢复正常：
   php artisan list

方案2：改为Laravel默认的App命名空间（仅适合业务代码量少的场景） #

1. 修改app/Console/Kernel.php的命名空间声明，将namespace HelloVideo\Console;替换为namespace App\Console;
2. 修改bootstrap/app.php中的Kernel绑定，将HelloVideo\Console\Kernel::class替换为App\Console\Kernel::class
3. 全局检查所有业务代码中的命名空间引用，将所有HelloVideo\前缀替换为App\
4. 手动删除bootstrap/cache目录下的所有缓存文件
5. 执行composer dump-autoload重新生成自动加载文件
6. 测试artisan命令是否恢复正常

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