拆分PHPUnit测试解决内存溢出，求大量单元测试下覆盖率报告生成方案

我之前维护PHP5.6老项目时，刚好碰到过一模一样的场景——随着测试用例越来越多，跑PHPUnit生成覆盖率报告直接中途爆内存报错。下面是我亲测有效的几个解决方案，按优先级推荐：

1. 拆分测试任务，分批生成后合并覆盖率 #

这是最有效的根本解决办法，把大量测试拆分成多个小批次，分别生成独立的覆盖率数据文件，最后再合并成完整报告。

• 按模块/目录拆分测试，比如先跑Module1的测试：

  php -d memory_limit=-1 vendor/bin/phpunit --coverage-php coverage-module1.cov --configuration phpunit.xml tests/Module1
  

• 再跑Module2的测试：

  php -d memory_limit=-1 vendor/bin/phpunit --coverage-php coverage-module2.cov --configuration phpunit.xml tests/Module2
  

• 最后用PHPUnit自带的合并工具（需PHPUnit 5.x及以上，兼容PHP5.6）生成完整HTML报告：

  vendor/bin/phpunit-merge coverage-module1.cov coverage-module2.cov --html ./coverage-report
  

• 在Jenkins里可以把这几步拆成多个Stage，前几个Stage分别跑不同批次的测试生成覆盖率文件，最后一个Stage执行合并。

2. 优化PHPUnit的覆盖率过滤配置 #

默认的覆盖率收集会包含很多不需要的文件，比如vendor依赖、第三方代码、测试文件本身，这些都会大幅增加内存占用。在phpunit.xml里精准配置白名单和排除项：

<filter>
    <whitelist processUncoveredFilesFromWhitelist="false">
        <!-- 只包含需要覆盖的业务代码目录 -->
        <directory suffix=".php">./src</directory>
        <!-- 排除不需要覆盖的文件/目录 -->
        <exclude>
            <directory suffix=".php">./src/ThirdPartyLibs</directory>
            <directory>./vendor</directory>
            <file>./src/Config.php</file>
        </exclude>
    </whitelist>
</filter>

重点：把processUncoveredFilesFromWhitelist设为false，这个选项默认会扫描白名单里所有未被测试覆盖的文件，非常消耗内存，关闭后只会收集被测试命中的文件。

3. 临时调整PHP内存限制 #

如果暂时没法拆分任务，先临时放宽PHP的内存限制作为应急方案：

• 在Jenkins的执行命令里直接指定：

  php -d memory_limit=-1 vendor/bin/phpunit --coverage-html ./coverage-report --configuration phpunit.xml
  

• 或者在phpunit.xml的<php>标签里设置：

  <php>
      <ini name="memory_limit" value="-1"/>
  </php>
  

注意：这只是缓解手段，不能从根本解决大量测试的内存问题，而且要确保Jenkins服务器有足够的物理内存支持。

4. 使用更轻量的覆盖率工具phpcov #

phpcov是PHPUnit官方推出的专门处理覆盖率的工具，比PHPUnit自带的覆盖率收集更高效，内存占用更低，完全兼容PHP5.6：

• 先用phpcov运行测试并收集覆盖率数据：

  php -d memory_limit=-1 vendor/bin/phpcov run --coverage-php coverage.cov vendor/bin/phpunit --configuration phpunit.xml
  

• 再生成HTML报告：

  vendor/bin/phpcov html coverage.cov --html ./coverage-report
  

5. 清理Jenkins工作区缓存 #

有时候Jenkins工作区里积累的旧覆盖率文件、临时缓存会占用额外内存，建议在每次构建前添加清理步骤：

rm -rf ./coverage-*.cov ./coverage-report

额外提醒 #

PHP5.6已经停止官方维护多年了，如果项目有条件，尽量升级到更高版本的PHP（比如7.4+），新版本的PHP内存管理更高效，PHPUnit的覆盖率收集也做了不少优化，能从根源减少这类问题。

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