--- title: DeepSeek 双机部署 HCCL 通信组创建失败排查与解决-官方技术文章-昇腾社区 description: 在集群部署DeepSeek等大模型时，`Create the hccl communication group failed` 错误多由跨机HCCL通信配置不当引发。根因常为ranktable文件中IP、端口或Rank映射错误，导致节点间无法建立可靠通信通道。 keywords: DeepSeek,双机部署,HCCL,通信组创建失,败排查与解决,官方技术文章,昇腾社区,背景概述 url: https://www.hiascend.com/developer/techArticles/20260724-4 section: (其他) --- # DeepSeek 双机部署 HCCL 通信组创建失败排查与解决-官方技术文章-昇腾社区 URL: https://www.hiascend.com/developer/techArticles/20260724-4 描述: 在集群部署DeepSeek等大模型时，`Create the hccl communication group failed` 错误多由跨机HCCL通信配置不当引发。根因常为ranktable文件中IP、端口或Rank映射错误，导致节点间无法建立可靠通信通道。 关键词: DeepSeek,双机部署,HCCL,通信组创建失,败排查与解决,官方技术文章,昇腾社区,背景概述 官方技术文章 [了解详情](https://www.hiascend.com/zh/developer/techArticles) DeepSeek 双机部署 HCCL 通信组创建失败排查与解决 DeepSeek 双机部署 HCCL 通信组创建失败排查与解决 技术文章HCCL 发表于: 2026/07/24 90 1 ## 背景概述 在集群部署DeepSeek等大模型时，`Create the hccl communication group failed`错误多由跨机HCCL通信配置不当引发。根因常为ranktable文件中IP、端口或Rank映射错误，导致节点间无法建立可靠通信通道。 ## 问题现象 在开发环境中部署 DeepSeek 双机推理服务时，进程启动失败，日志中明确报错： text 1 Create the hccl communication group failed Create the hccl communication group failed ## 故障排查过程 针对上述报错，我们按照从底层网络到上层配置逻辑的顺序进行了逐步排查： ### 1. 排查网络节点 首先确认节点间的网络状态及 NPU 互联情况。 ● 节点网络状态：通过`ifconfig`或`ip addr`检查，各节点网卡状态均为 UP，IP 配置正常。 ● NPU 互联 Ping 测试：使用`hccn_tool`或系统 ping 命令测试两机 NPU 接口间的连通性，结果显示延迟正常，无丢包，网络层面无异常。 ### 2. 配置文件分析 在网络连通性正常的情况下，重点排查 HCCL 通信所需的拓扑配置文件`ranktable`。 ● 主节点配置：检查主节点（Node 0）的`ranktable`，其`rank_id`分配为`0-7`，符合预期。 ● 副节点配置：检查副节点（Node 1）的`ranktable`，发现其`rank_id`被错误地配置为`0-7`。 异常点：在双机 16 卡部署场景下，全局 Rank ID 应当是连续的唯一标识。副节点的 Rank ID 应当接续主节点，即使用`8-15`，而非重新从`0`开始。 ## 问题根因 HCCL 在创建跨机通信组时，要求所有参与通信的 NPU 拥有全局唯一且连续的`rank_id`。 在本案例中，副节点的`ranktable`文件中`rank_id`使用了非连续的全局编号（即重复使用了 0-7），导致 HCCL 无法正确映射全局通信拓扑，从而抛出`Create the hccl communication group failed`错误。 ## 解决措施 修正`ranktable`文件中的`rank_id`分配，确保全局编号连续且唯一。 1. 修改副节点 ranktable：将副节点（Node 1）的`rank_id`从`0-7`修改为`8-15`。 2. 验证配置：确保主节点`rank_id`为`0-7`，副节点`rank_id`为`8-15`，且所有节点的 IP 地址与端口配置正确对应。 3. 重启服务：重新执行部署脚本或重启推理服务，确认 HCCL 通信组创建成功，DeepSeek 推理服务正常启动。 边框设置 无框线 边距 宽度 1磅 颜色 自由布局设置 整体布局 子模块 评论 修订记录 对正文进行的文本增删、样式修改都将标记为修订 自定义多级列表 列表设置 - 1 - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 1. - a. - i. - 1. - a. - i. - 1. - a. - i. 前缀 无 序号 1 2 3 ... 后缀 . 编号格式 列表显示 继承层级 不继承 位置 对齐方式 默认 单元格边距 边距 默认 左边距 cm 右边距 cm 上边距 cm 下边距 cm 点赞 1 本页内容 背景概述 [了解详情](https://www.hiascend.com/#6vNr53rXjbt4sHuRjtWqRF) 问题现象 [了解详情](https://www.hiascend.com/#1SKpyLgZYExlDjWjcZnXmN) 故障排查过程 [了解详情](https://www.hiascend.com/#3cCgnMh2oUi6uQVf89aVO8) 问题根因 [了解详情](https://www.hiascend.com/#1Wjh81UggLb76W9q6zoC0D) 解决措施 [了解详情](https://www.hiascend.com/#4WfMGRllQ5cw3d0Z3Q1XBl)