Laravel包开发（Orchestra Testbench）使用Laravel Excel报错excel不存在

你碰到的服务加载失败，本质是Orchestra Testbench的测试环境默认不会自动读取你包composer.json里extra.laravel.providers配置的服务项——这个配置的作用是给包被最终Laravel应用安装时做自动发现用的，Testbench构建测试专用Laravel实例时，只会扫描已经写入服务发现缓存的第三方包配置，你当前本地开发的包还没有被纳入Testbench的服务发现扫描范围，自然不会自动加载你声明的Excel服务提供者。

• 先修正composer.json的格式问题：你现在写的aliases配置块最后多了个尾随逗号，属于不严谨的JSON语法，先删掉避免解析异常。
• 找到你项目里的Testbench测试基类（一般是tests/TestCase.php，继承Orchestra\Testbench\TestCase的文件），重写两个方法完成手动注册：
  1. 重写getPackageProviders方法，把Laravel Excel的服务提供者加入测试环境的注册列表：

  protected function getPackageProviders($app)
  {
      return [
          // 保留你自己包的核心服务提供者
          \Your\Package\ServiceProvider::class,
          // 注册Laravel Excel的核心服务提供者
          \Maatwebsite\Excel\ExcelServiceProvider::class,
      ];
  }
  

  2. 重写getPackageAliases方法，把Excel门面的别名注册到测试容器里，避免门面解析时找不到对应绑定：

  protected function getPackageAliases($app)
  {
      return [
          'Excel' => \Maatwebsite\Excel\Facades\Excel::class,
      ];
  }
  

• 确认所有用到Laravel应用容器的测试用例，都是继承上面自定义的Testbench测试基类，而不是直接继承PHPUnit的原生TestCase——如果直接用原生TestCase，根本不会初始化Laravel容器，自然会报找不到excel绑定的错误。
• 调整业务类的依赖注入方式：你现在在TaxCalculation类里直接静态调用Excel门面的写法，在容器绑定正常的环境下能跑，但耦合度太高，建议改成构造函数注入Excel的核心类，不管测试环境还是最终线上环境都能正常解析：

  use Maatwebsite\Excel\Excel;
  
  class TaxCalculation
  {
      public function __construct(
          protected Excel $excelHandler
      ) {}
  
      public function incomeTax(): float
      {
          $this->excelHandler->import(new TaxImport(), 'file.xls');
          // 补充对应业务返回逻辑
      }
  }
  

• 不要把maatwebsite/excel一直放在require-dev节点下：如果你的包对外提供的功能本身依赖Laravel Excel，这个依赖要移到require节点下，否则其他项目安装你的包时会出现依赖缺失的问题。

注意：配置完成后如果仍然报找不到类的错误，直接删除vendor/orchestra/testbench-core/laravel/bootstrap/cache目录下的所有缓存文件即可，Testbench会缓存已经加载的服务提供者列表，旧缓存会导致新配置不生效。

• 不需要反复跑composer dump-autoload：只要自动加载的类路径是正确的，服务加载的问题和dump命令无关，只要在测试基类里正确注册了提供者，Testbench启动时就会自动加载对应服务。

小提示：你写的incomeTax方法定义了float返回类型，但方法内部没有任何返回语句，等服务加载正常后会触发返回值类型不匹配的PHP错误，可以提前补上对应的返回逻辑。

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