RectorPHP项目中的子进程超时问题分析与解决方案

问题现象

在使用RectorPHP进行代码重构时，部分用户遇到了子进程超时的问题，即使已经禁用了并行处理功能。错误信息显示"Child process timed out after 120 seconds"，并且当系统错误达到50次限制时会终止执行。

问题根源

这个问题实际上源于RectorPHP配置文件的编写方式不当。用户同时使用了两种配置格式：

1. RectorConfig::configure()链式调用
2. 返回闭包函数的形式

这两种配置方式混用导致了配置冲突，使得disableParallel()的设置未能正确生效。

解决方案

正确配置方式

RectorPHP支持两种配置方式，但只能选择其中一种：

方式一：链式调用

use Rector\Config\RectorConfig;

return RectorConfig::configure()
    ->withRules([
        // 规则配置
    ])
    ->withPreparedSets(
        deadCode: true,
        codeQuality: true
    )
    ->disableParallel();

方式二：闭包函数

use Rector\Config\RectorConfig;

return static function (RectorConfig $rectorConfig): void {
    $rectorConfig->rules([
        // 规则配置
    ]);
    
    $rectorConfig->sets([
        // 预设配置
    ]);
    
    $rectorConfig->disableParallel();
};

其他优化建议

1. 调整超时时间：如果确实需要并行处理，可以通过->parallel()方法调整超时时间和进程数

   ->parallel(processTimeout: 300, maxNumberOfProcess: 4)
   

2. 减少处理规模：对于大型项目，可以尝试减小每次处理的文件数量

   ->parallel(jobSize: 10)
   

3. 分步处理：将重构任务分解为多个小任务，分别执行

最佳实践

1. 始终使用单一配置方式
2. 对于大型项目，建议先在小范围测试重构规则
3. 监控执行过程，根据实际情况调整参数
4. 保持RectorPHP版本更新，以获取最新的性能优化

通过正确的配置和参数调整，可以有效避免子进程超时问题，使RectorPHP的重构工作更加顺畅高效。