Laravel9升级后运行phpunit报TestCase类未找到如何修复

问题场景 #

项目从Laravel 8升级至Laravel 9后，通过artisan命令生成的测试类符合框架规范，但运行phpunit时抛出如下致命错误：

PHP Fatal error:  Uncaught Error: Class "Tests\TestCase" not found in path/to/SimpleTest.php:9

修复步骤 #

按顺序排查操作即可解决：

• 校验测试基类文件完整性
  检查根目录下tests/TestCase.php是否存在，文件缺失则手动创建，内容如下：

  <?php
  
  namespace Tests;
  
  use Illuminate\Foundation\Testing\TestCase as BaseTestCase;
  
  abstract class TestCase extends BaseTestCase
  {
      use CreatesApplication;
  }
  

  同时确认同目录下存在CreatesApplication.php文件，该trait负责测试环境的应用启动引导，升级过程中丢失可直接从Laravel 9默认项目骨架中复制对应内容补全。
• 修正Composer自动加载配置
  打开根目录composer.json，找到autoload-dev配置节点，确认Tests命名空间已正确映射到测试目录，正确配置参考：

  "autoload-dev": {
      "psr-4": {
          "Tests\\": "tests/"
      }
  },
  

  升级过程中配置遗漏、映射路径错误是触发该问题的最常见原因。
• 重新生成自动加载映射
  配置调整完成后，在项目根目录执行命令重载自动加载文件：

  composer dump-autoload
  

• 改用项目内置命令运行测试
  不要使用全局安装的phpunit执行测试，全局版本与项目依赖的phpunit版本不兼容也会触发类加载错误，优先使用框架自带的测试命令：

  php artisan test
  

  也可直接调用项目依赖内的phpunit二进制文件执行：

  ./vendor/bin/phpunit
  

以上操作完成后仍报错的，可检查根目录phpunit.xml配置文件是否在升级过程中损坏，替换为Laravel 9默认的phpunit配置后重试即可。

内容的提问来源于stack exchange，提问作者Aryabhima A. Rahman