使用@runInSeparateProcess注解的PHPUnit执行冻结如何解决？

@runInSeparateProcess 注解使用合理性判断 #

这属于完全合理的使用场景。你遇到的session_start(): Session cannot be started after headers have already been sent报错根源是PHPUnit默认在单进程内串行执行所有测试用例，前序用例执行过程中如果产生了输出、发送过header或者启动过会话，都会修改PHP的全局状态，后续涉及会话初始化的用例必然触发报错。@runInSeparateProcess 是PHPUnit官方提供的全局状态隔离机制，专门用于处理这类依赖纯净全局状态的测试场景。

替代方案 #

如果不想依赖进程隔离，可以采用以下方案解决报错问题：

• 重构被测代码：将session启动、header发送这类全局操作封装为可注入的独立服务，单元测试时用Mock对象替换真实实现，从根源避免全局状态冲突，同时也能提升代码的可测试性。
• 新增测试前置清理逻辑：在测试类的setUp()方法中加入全局状态重置代码，示例如下：

protected function setUp(): void
{
    parent::setUp();
    ob_end_clean(); // 清理之前的输出缓冲区
    header_remove(); // 清空已发送的header
    if (session_status() === PHP_SESSION_ACTIVE) {
        session_destroy();
    }
}

• 全局配置进程隔离：在phpunit.xml中为测试套件全局开启processIsolation="true"，不需要逐个测试方法添加注解。

覆盖率模式下测试冻结的修复方案 #

该问题是PhpStorm 2021.2版本、xdebug覆盖率采集、PHPUnit进程隔离三者的兼容问题，Docker环境下的PHP进程限制会加剧阻塞，可按以下优先级尝试修复：

1. 优先升级PhpStorm到2021.3及以上版本，该版本官方修复了单独进程场景下的覆盖率数据回传兼容Bug。如果暂时无法升级，打开PhpStorm对应测试的运行配置，勾选「Pass required coverage options to PHPUnit」选项，替换IDE默认的覆盖率注入逻辑。
2. 调整Docker内PHP CLI的xdebug配置：在php.ini中添加以下配置

xdebug.mode=coverage
xdebug.start_with_request=no
xdebug.client_host=host.docker.internal # 确保xdebug能正确回传数据到宿主

3. 为带@runInSeparateProcess注解的测试方法追加@preserveGlobalState disabled注解，关闭PHPUnit的全局状态序列化传输逻辑，减少子进程启动时的开销和数据冲突。
4. 若以上方案都不生效，改用命令行生成覆盖率报告：在Docker容器内执行./vendor/bin/phpunit --coverage-html ./coverage-report，生成静态HTML报告后直接在浏览器查看，完全规避IDE层面的兼容问题。

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