Laravel9+PHP8.1环境下PHPUnit首次加载测试文件失败，二次尝试正常

这种现象大概率和phpunit.xml配置有关，但也可能涉及测试环境初始化、缓存等其他因素，以下是具体排查点：

一、phpunit.xml 配置相关问题 #

• 缓存驱动配置：如果未在phpunit.xml中明确设置测试环境的缓存驱动为array，首次测试可能会使用文件/数据库缓存，导致残留数据干扰。检查配置是否包含：

  <env name="CACHE_DRIVER" value="array"/>
  <env name="SESSION_DRIVER" value="array"/>
  

• 数据库配置：若测试依赖数据库，需确认phpunit.xml中指定了独立的测试数据库，且测试类正确使用事务回滚或刷新数据库特性：

  <env name="DB_DATABASE" value="your_test_db"/>
  

  同时确保测试类引入了use Illuminate\Foundation\Testing\RefreshDatabase;或use Illuminate\Foundation\Testing\DatabaseTransactions;。
• 环境变量加载：检查phpunit.xml中的环境变量是否完整覆盖生产配置，避免首次运行时部分配置未正确加载（比如第三方服务密钥、文件存储路径）。
• Bootstrap 配置：确认<bootstrap>节点指向正确的初始化文件，Laravel 测试通常应为：

  <bootstrap>vendor/autoload.php</bootstrap>
  

二、非配置类问题 #

• 测试初始化逻辑：检查测试类的setUp方法，确保每次测试前都重置了依赖资源（比如临时文件、服务容器绑定），避免首次运行时资源未初始化完成。
• Laravel 容器缓存：首次运行时服务容器可能未完成全部绑定，可在测试前执行php artisan clear-compiled清理容器缓存。
• PHP OPcache 干扰：若开启了 OPcache，首次加载测试文件可能存在缓存异常，可临时关闭 OPcache 后重试测试。

排查步骤建议 #

1. 先备份当前phpunit.xml，替换为 Laravel 默认的phpunit.xml.dist内容，测试是否还出现首次失败的情况。
2. 每次测试前执行清理命令：

   php artisan config:clear && php artisan cache:clear && php artisan clear-compiled
   

3. 单独运行单个测试文件，观察是否依旧存在首次失败的现象，缩小问题范围。

内容的提问来源于stack exchange，提问作者Lyan Dwi Pangestu