Laravel包开发测试报错：Undefined variable $original（PHPUnit+Testbench）

可能的原因及修复方案 #

1. 修复框架版本兼容性问题 #

这个错误多是特定Laravel版本的Query Builder存在bug导致的，比如部分5.x、8.x分支的版本存在该变量未定义的问题。

• 操作：在composer.json中指定对应分支的最新稳定版，例如"laravel/framework": "^8.83"，执行composer update完成版本升级；若升级有阻碍，可降级到已知无此问题的稳定版本。

2. 排查包内自定义代码 #

如果包内有自定义迁移、模型或查询逻辑，可能存在误用$original变量的情况。

• 操作：
  • 检查所有迁移文件中的DB查询语句，确认没有引用未定义的$original。
  • 排查包内模型的boot方法、全局作用域、自定义查询方法，确保在Query Builder上下文里没有错误使用未声明的变量。

3. 清理测试环境缓存 #

测试环境的缓存残留可能引发旧代码逻辑冲突，导致变量未定义。

• 操作：在测试类的setUp方法中添加缓存清理逻辑：

  public function setUp(): void
  {
      parent::setUp();
      $this->artisan('cache:clear');
      $this->artisan('config:clear');
  }
  

  也可手动删除测试环境bootstrap/cache目录下的所有文件。

4. 匹配Testbench与Laravel版本 #

Orchestra Testbench版本与Laravel框架不兼容时，可能触发此类底层错误。

• 操作：根据Laravel版本调整Testbench版本，例如Laravel 8对应orchestra/testbench:^6.0，Laravel 9对应orchestra/testbench:^7.0，修改composer.json后执行composer update。

5. 更换迁移加载方式 #

用Testbench提供的迁移加载方法替代直接执行artisan命令，避免上下文冲突。

• 操作：在测试类中使用以下代码加载迁移：

  public function setUp(): void
  {
      parent::setUp();
      $this->loadMigrationsFrom(__DIR__.'/../database/migrations');
  }
  

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