mpi4py初始化MPIPool提示仅1个MPI进程可用问题咨询

该报错与你使用OpenMPI还是MPICH无关，核心是脚本启动方式错误：直接执行python 你的脚本名.py时，MPI运行时仅会拉起1个进程，MPI.COMM_WORLD.Get_size()返回值必然为1，自然触发MPIPool的进程数校验逻辑。
你之前跑官方基准测试能得到正常结果，恰恰说明当前MPI环境完全可用——那次测试是通过mpiexec启动器拉起了多个MPI进程，符合MPI程序的运行要求。

方案1：通过mpiexec启动业务脚本（零代码修改，优先选用） #

和跑基准测试的逻辑一致，用mpiexec命令拉起你的脚本即可，注意总进程数至少设置为2：MPIPool默认将rank 0作为调度进程，剩余进程作为工作进程，因此-n参数最小传2，需要更多并行算力就调大该值。
示例命令：

# 启动1个调度进程+4个工作进程，共5个MPI进程，和你之前基准测试的进程数一致
mpiexec -n 5 python your_script.py

注意：MPI的进程生命周期完全由mpiexec管理，不需要在Python代码中额外编写多进程拉起逻辑，直接运行你原有if __name__ == "__main__"块下的代码即可。

方案2：单进程调试兼容（仅本地调试阶段使用） #

如果只是验证代码逻辑、不需要并行算力，可以在初始化MPIPool前加判断，单进程场景下走串行逻辑或者Python原生进程池，避免触发报错：

if __name__ == "__main__":
    from mpi4py import MPI
    world_size = MPI.COMM_WORLD.Get_size()
    if world_size < 2:
        print("单进程模式运行，使用串行逻辑调试")
        # 此处写串行调试逻辑，可替换为concurrent.futures.ProcessPoolExecutor实现本地并行
    else:
        pool = MPIPool()
        # 原有MPI并行逻辑

方案3：临时修改MPIPool校验阈值（不推荐，仅应急使用） #

从MPIPool源码可见，它将总进程数减1作为工作进程数，要求至少有1个工作进程才会正常初始化。如果需要临时在单进程环境跑通全流程，可以找到mpipool.py文件中对应的校验代码，把判断条件临时放宽，但这种方式会完全丢失MPI并行能力，仅适合流程验证：

# 原代码判断条件为if self.size == 0:
if self.size < 0:
    raise ValueError("Tried to create an MPI pool, but there "
                     "was only one MPI process available. "
                     "Need at least two.")

• 只要执行mpiexec -n 5 python -m mpi4py.bench helloworld能正常输出多进程问候语，就说明mpi4py和系统MPI的绑定是正常的，不需要重装MPI组件。
• 用mpiexec启动脚本时，不要嵌套其他多进程启动命令，也不要随意加后台运行符，避免出现进程数识别异常。

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