使用AMPHP parallel执行多线程任务时报打开文件过多、类未找到错误

问题根因 #

第一个Too many open files警告是核心错误，第二个类未找到的致命错误是该警告的衍生问题：

• macOS系统默认的单进程可打开文件句柄上限极低（通常为256），使用amphp/parallel-functions执行多线程任务时，每个子进程会继承父进程的打开句柄，同时类加载、文件操作都会占用句柄，当并发任务量达到阈值后，句柄被耗尽就会触发文件加载失败警告
• 类加载链路被打断后，后续逻辑依赖的Amp\Failure等类无法正常加载，就会抛出类未找到的致命错误

诱发该问题的常见场景：

• 近期上调了并行任务的并发数，超过了之前的运行阈值
• 代码存在文件句柄、子进程资源未及时释放的逻辑
• amphp/parallel 1.x分支在macOS环境下存在已知的资源回收效率偏低的问题

解决办法 #

1. 调高系统文件句柄限制（macOS专属） #

临时生效（当前终端会话有效）：
ulimit -n 10240

永久生效：在~/.zshrc（zsh用户）或~/.bash_profile（bash用户）中加入上述命令，重启终端后自动生效。

2. 控制并发池大小 #

不要使用无上限的并发，手动指定并行池的最大并发数，建议不超过CPU核心数的4倍：

use Amp\Parallel\Worker\DefaultPool;
use function Amp\ParallelFunctions\parallelMap;

// 示例：限制最大并发为8，根据实际业务场景调整
$pool = new DefaultPool(8);
$result = parallelMap($待处理数组, $处理回调, $pool);
// 任务执行完后手动销毁池，释放资源
$pool->shutdown();

3. 修复资源泄漏 #

• 所有主动打开的文件资源操作完成后必须执行fclose释放
• 公共资源、公共配置的加载逻辑放到父进程执行，不要在每个子进程闭包里重复加载
• 避免在并行任务中执行频繁的文件读写操作

4. 更新依赖到兼容的最新版本 #

执行composer命令更新amphp相关组件，修复已知的资源泄漏问题：
composer update amphp/parallel amphp/parallel-functions amphp/process

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