Laravel6升级至11后单元测试提示Target class [config]不存在

问题描述 #

将Laravel应用从6版本升级到11版本，完成所有依赖库升级后，运行单元测试时出现错误：Target class [config]不存在，错误触发位置为C:\xampp\htdocs\service-lar\vendor\laravel\framework\src\Illuminate\Container\Container.php:944。但使用tinker时可正常读取配置文件的值，仅PHPUnit测试场景会触发该问题。

错误栈 #

#0 C:\xampp\htdocs\service-lar\vendor\laravel\framework\src\Illuminate\Container\Container.php(944): ReflectionClass->__construct('config')
#1 C:\xampp\htdocs\service-lar\vendor\laravel\framework\src\Illuminate\Container\Container.php(819): Illuminate\Container\Container->build('config')
#2 C:\xampp\htdocs\service-lar\vendor\laravel\framework\src\Illuminate\Container\Container.php(755): Illuminate\Container\Container->resolve('config', Array)
#3 C:\xampp\htdocs\service-lar\vendor\laravel\framework\src\Illuminate\Foundation\helpers.php(124): Illuminate\Container\Container->make('config', Array)
#4 C:\xampp\htdocs\service-lar\vendor\laravel\framework\src\Illuminate\Foundation\helpers.php(279): app('config')
#5 C:\xampp\htdocs\service-lar\app\Services\PriceService.php(23): config('configfile.currency...')

已尝试操作 #

• 清理并重建缓存：执行php artisan config:clear、php artisan cache:clear、php artisan optimize:clear
• 验证测试引导配置：检查phpunit.xml配置及TestCase设置
• 确认配置文件有效性：验证configfile.php配置文件包含有效值
• 检查服务提供者：确认服务提供者列表配置正确
• 调整依赖解析方式：测试中尝试使用app()或resolve()解析依赖

问题核心 #

tinker环境可正常访问config值，但PHPUnit测试无法访问；错误触发于测试解析PriceService服务时，该服务通过config()助手函数获取配置值。

额外信息 #

• Laravel版本：11
• PHPUnit版本：[请填写实际版本]
• PHP版本：[请填写实际版本]

原因分析 #

1. 测试框架引导不完整：Laravel 11对测试环境的引导逻辑做了调整，若测试类未继承官方的Tests\TestCase，或phpunit.xml配置错误，会导致容器未正确初始化Config服务。
2. 单元测试未启动完整框架：若测试为纯单元测试（未启用框架容器），直接实例化PriceService会导致config()助手无法访问容器中的Config服务。
3. 测试环境缓存残留：清理缓存时未指定testing环境，导致测试环境仍存在旧的缓存配置。
4. 升级后服务注册缺失：Laravel 11移除了config/app.php中的自动服务提供者注册，改用bootstrap/app.php注册服务，若升级过程中未同步调整，可能导致ConfigServiceProvider未在测试环境注册。

解决方案 #

1. 确保测试类继承正确的TestCase：所有测试类必须继承Tests\TestCase，该类默认会完成Laravel框架的初始化工作：

   namespace Tests\Unit;
   
   use Tests\TestCase;
   
   class PriceServiceTest extends TestCase
   {
       // 测试代码
   }
   

2. 清理测试环境缓存：执行指定环境的缓存清理命令：

   php artisan config:clear --env=testing
   php artisan optimize:clear --env=testing
   

3. 检查phpunit.xml配置：确认phpunit.xml中指定了正确的环境和引导文件：

   <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
            bootstrap="tests/bootstrap.php"
            colors="true">
       <testsuites>
           <testsuite name="Unit">
               <directory suffix="Test.php">./tests/Unit</directory>
           </testsuite>
       </testsuites>
       <php>
           <env name="APP_ENV" value="testing"/>
           <!-- 其他环境变量配置 -->
       </php>
   </phpunit>
   

4. 通过容器解析PriceService：测试中不要直接new PriceService()，而是通过容器获取实例，确保依赖注入正常：

   $priceService = $this->app->make(PriceService::class);
   // 或者使用resolve助手
   $priceService = resolve(PriceService::class);
   

5. 验证bootstrap/app.php的服务注册：确认bootstrap/app.php中已正确注册Config服务（Laravel 11默认自动注册，若有自定义修改需检查）：

   return Application::configure(basePath: dirname(__DIR__))
       ->withProviders([
           // 确保Illuminate\Config\ConfigServiceProvider在其中
       ])
       ->create();
   

6. 启用框架引导的单元测试：若需要在单元测试中使用框架功能，添加Illuminate\Foundation\Testing\RefreshDatabase或Illuminate\Foundation\Testing\WithFaker等trait，确保容器初始化完成。

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