Xdebug与PHPUnit运行时内存耗尽致容器崩溃，求解决办法

问题背景 #

使用docker-compose run --rm phpunit --coverage-html生成覆盖率报告时，PHPUnit会耗尽容器内存、CPU资源，最终导致容器崩溃；但不添加--coverage-html选项时，测试运行完全正常。当前Dockerfile中已设置PHP内存无限制（memory_limit = -1），并配置Xdebug用于覆盖率收集。

解决办法 #

1. 给PHP设置合理内存上限（避免无限制）

当前设置的memory_limit = -1会让PHP无节制占用内存，直到容器资源耗尽。改成一个合理的上限，比如2G，可在Dockerfile中修改：

RUN echo memory_limit = 2G >> /usr/local/etc/php/conf.d/docker-php-memlimit.ini;

或者运行命令时临时覆盖配置：

docker-compose run --rm -e PHP_MEMORY_LIMIT=2G phpunit --coverage-html

2. 缩小覆盖率扫描范围

默认情况下PHPUnit会扫描所有文件，通过phpunit.xml配置排除不需要覆盖的目录（如vendor、config、public等），能大幅降低内存占用：

<filter>
    <whitelist processUncoveredFilesFromWhitelist="true">
        <directory suffix=".php">./src</directory>
        <exclude>
            <directory suffix=".php">./src/ThirdPartyCode</directory>
            <file>./src/UnnecessaryFile.php</file>
        </exclude>
    </whitelist>
</filter>

3. 拆分测试任务，分批生成覆盖率

不要一次性运行所有测试，按目录或测试组拆分任务，生成多个覆盖率数据文件后再合并成HTML报告：

# 先跑单元测试，生成覆盖率数据
docker-compose run --rm phpunit --coverage-php coverage-unit.cov tests/Unit/
# 再跑集成测试
docker-compose run --rm phpunit --coverage-php coverage-integration.cov tests/Integration/
# 合并所有数据生成HTML报告
phpunit --coverage-html coverage-report --merge coverage-unit.cov coverage-integration.cov

4. 优化Xdebug覆盖率配置

Xdebug默认的覆盖率收集存在冗余，调整配置减少内存消耗，在/usr/local/etc/php/conf.d/xdebug.ini中修改：

xdebug.mode=coverage
xdebug.start_with_request=yes
# 仅扫描src目录下的文件
xdebug.coverage_filter=./src
# 关闭不必要的客户端主机发现
xdebug.discover_client_host=0

同时建议升级到Xdebug最新稳定版，旧版本可能存在内存泄漏问题。

5. 给Docker容器设置资源配额

在docker-compose.yml中为phpunit服务添加CPU和内存限制，避免耗尽宿主机资源：

services:
  phpunit:
    build:
      context: .
      dockerfile: phpunit.dockerfile
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 3G
        reservations:
          cpus: '0.5'
          memory: 1G

6. 换用更轻量的覆盖率工具

如果Xdebug+PHPUnit的组合内存占用过高，可替换为专门做覆盖率收集的pcov，它比Xdebug更节省内存：

1. 在Dockerfile中替换Xdebug为pcov：

   # 删除原有Xdebug安装步骤
   # 安装pcov
   RUN pecl install pcov
   RUN docker-php-ext-enable pcov
   

2. 运行PHPUnit时指定使用pcov：

   docker-compose run --rm phpunit --coverage-html --coverage-php pcov.cov
   

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