【合入来源】

• 需求
• 问题单
• issue/工单
• 重构优化
• 资料更新

Issue: https://gitcode.com/Ascend/pytorch/issues/3208

【修改方案】

Add Python validation tests for torch.distributed.distributed_c10d.ProcessGroupMPI.create in test/distributed/test_c10d_mpi.py.

The PyTorch community has C++ coverage for the MPI process group but no direct Python tests for this API. The tests cover MPI availability and import guards, factory creation and properties, non-member behavior, process-group initialization, and allreduce/broadcast/barrier operations.

【资料变更】

不涉及。This is a backend control API and no native API documentation update is required.

【接口变更】

不涉及。

【功能验证】

The test was run with an absolute path outside the source tree:
python -m pytest test/distributed/test_c10d_mpi.py -q

Result: 4 passed, 14 skipped. The skipped cases require an MPI runtime and a PyTorch build compiled with MPI support; this is expected in the current environment. ProcessGroupMPI is a backend/control API, so the test does not require NPU tensors.

【CheckList】

• 代码注释完备，正确记录错误日志
• 代码实现进行了返回值、空指针等校验
• PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等
• PR持续集成流水线（CI）执行通过，代码检查无异常

NPU 功能验证补充

以下为当前 PR head commit 对应的单卡 NPU 实测环境、命令和结果：

TASK 99 / PR #42950 / VALIDATION EVIDENCE
API=torch.distributed.distributed_c10d.ProcessGroupMPI.create
TARGET_BRANCH=v2.12.0
PLATFORM=Linux-5.10.0-216.0.0.115.oe2203sp4.aarch64-aarch64-with-glibc2.35
PYTHON=3.11.15
TORCH=2.12.0+cu130
TORCH_NPU=2.12.0.rc1
CANN=9.1.0.beta1
NPU=Ascend910_9382
VISIBLE_NPU=1 (PHYSICAL NPU 0)
COMMAND=scripts/run_api_python_version.sh 2.12.0
  sources/review/task99-v2.12.0/test/distributed/test_c10d_mpi.py -v
RESULT:
  Ran 18 tests in 0.181s
  OK (skipped=14)
  test_exit_code=0
NOTE=MPI is not compiled; direct create cases were skipped

说明：当前 PyTorch wheel 未编译 MPI；18 项中 14 项直接 MPI/create 用例按条件跳过。本次结果证明不可用路径及测试文件可正常执行，不表述为 ProcessGroupMPI.create 已在本机实际运行。

【合入来源】

• 需求
• 问题单
• issue/工单
• 重构优化
• 资料更新

Issue: https://gitcode.com/Ascend/pytorch/issues/3208

【修改方案】

Add Python validation tests for torch.distributed.distributed_c10d.ProcessGroupMPI.create in test/distributed/test_c10d_mpi.py.

The PyTorch community has C++ coverage for the MPI process group but no direct Python tests for this API. The tests cover MPI availability and import guards, factory creation and properties, non-member behavior, process-group initialization, and allreduce/broadcast/barrier operations.

【资料变更】

不涉及。This is a backend control API and no native API documentation update is required.

【接口变更】

不涉及。

【功能验证】

The test was run with an absolute path outside the source tree:
python -m pytest test/distributed/test_c10d_mpi.py -q

Result: 4 passed, 14 skipped. The skipped cases require an MPI runtime and a PyTorch build compiled with MPI support; this is expected in the current environment. ProcessGroupMPI is a backend/control API, so the test does not require NPU tensors.

CI validation is pending.

【CheckList】

• 代码注释完备，正确记录错误日志
• 代码实现进行了返回值、空指针等校验
• PR标题正确使用类型标签，如：feat、fix、refactor、docs、test等
• PR持续集成流水线（CI）执行通过，代码检查无异常