Laravel 9测试与config:cache报错：RecursiveDirectoryIterator目录参数为空

问题场景 #

开发Laravel REST API时，遇到两个关联问题：

1. 第二个测试函数执行失败，抛出错误：RecursiveDirectoryIterator::__construct(): Argument #1 ($directory) cannot be empty
2. 运行php artisan config:cache时复现该错误——清除缓存阶段使用完整配置目录路径正常，但读取配置进行缓存时，$app->configPath()返回相对路径\config，导致报错

已确认config目录存在，尝试过删除vendor重装，且php artisan serve可正常启动应用。

可能原因及对应解决方案 #

1. 配置路径被错误修改

Laravel默认通过config_path()生成基于项目根目录的绝对路径，若返回相对路径，大概率是代码中手动覆盖了配置路径：

• 检查bootstrap/app.php、自定义服务提供者或中间件中是否调用了$app->useConfigPath()，确认传入的是绝对路径（比如base_path('config')）而非相对路径\config。
• 查看.env文件，若存在自定义CONFIG_PATH环境变量，直接删除或修正为绝对路径。

2. 测试环境应用实例初始化异常

测试用例中重置应用时可能未正确初始化配置路径：

• 检查测试类的setUp()/tearDown()方法，确认没有错误修改配置路径的逻辑。
• 临时在测试方法开头添加代码强制指定配置路径：

  $this->app->useConfigPath(base_path('config'));
  

  验证是否解决问题，再排查根源。

3. 缓存文件残留路径错误

旧缓存文件可能留存了错误的路径信息：

• 手动删除bootstrap/cache目录下的所有文件，依次执行：

  php artisan config:clear
  php artisan config:cache
  

4. Windows路径分隔符硬编码问题

错误路径\config是Windows分隔符，若代码中硬编码路径分隔符会导致跨环境或路径解析异常：

• 替换所有手动拼接的路径代码，统一使用Laravel提供的辅助函数（base_path()、config_path()），避免直接写\config这类硬编码路径。

5. Composer自动加载异常

即使重装了vendor，自动加载文件可能未正确生成：

• 执行命令重新生成优化后的自动加载文件：

  composer dump-autoload -o
  

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