为何PHP的pcntl_fork在WSL2环境下无法并行运行两个以上子进程？

问题核心 #

使用pcntl_fork()创建5个子进程，预期所有子进程并行执行sleep(1)，总耗时约1秒；但在Windows 11 WSL2环境的Docker容器中，实际每次仅能运行2个子进程，总耗时约3.5秒。原生Linux主机的Docker环境可正常复现预期结果。

可能原因及排查解决步骤 #

1. Docker Desktop默认CPU资源分配限制 #

Docker Desktop默认可能仅为WSL2分配2核CPU，即使主机有更多核心，这会导致容器内进程最多并行2个。

• 排查：打开Docker Desktop → 设置 → Resources → Advanced，查看CPU分配数量。
• 解决：将CPU滑块拉到最大（匹配你的20核），应用设置后重启Docker和WSL。

2. WSL2内核进程/线程调度限制 #

部分WSL2默认配置存在隐性的进程调度限制，或旧版本内核存在bug。

• 更新WSL2内核：
  在Windows命令提示符执行：

  wsl --update
  wsl --shutdown
  

  重启WSL后再测试。
• 检查进程数限制：
  在WSL2主机和容器内分别执行：

  ulimit -u
  

  若返回值远小于20，可修改WSL配置文件/etc/wsl.conf（WSL2主机内）：

  [limits]
  processors=20
  

  保存后执行wsl --shutdown重启生效。

3. 容器内CPU cgroup限制 #

即使未手动设置资源控制，WSL2的环境可能间接给容器施加了CPU配额限制。

• 排查：在容器内执行：

  cat /sys/fs/cgroup/cpu/cpu.cfs_quota_us
  cat /sys/fs/cgroup/cpu/cpu.cfs_period_us
  

  若cpu.cfs_quota_us不为-1，说明存在CPU时间限制。
• 解决：启动容器时手动添加--cpus=20参数，强制分配全部CPU资源：

  docker run --cpus=20 [你的容器镜像]
  

4. 验证系统层面并行能力 #

先排除PHP本身的问题，测试纯Shell命令的并行性：
在容器内执行：

for i in {1..5}; do echo "Start $i" && sleep 1 && echo "End $i" & done; wait

若该命令总耗时约1秒，说明是PHP pcntl扩展的环境适配问题；若同样耗时3.5秒，则确认是系统层面的资源限制问题。

5. PHP pcntl扩展版本差异 #

检查容器内PHP pcntl扩展版本是否与原生Linux环境一致：

php -i | grep pcntl

若版本不一致，尝试更换与原生环境相同的PHP镜像版本。

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