在您提交issue前，请确认以下信息：

• 我已经搜索过现有和历史issues，确认这是一个新问题
• 我已经阅读过常见问题定位手册，仍无法解决当前问题

问题定位请提供通信两端报错日志！

CANN日志默认路径：$HOME/ascend/log/，若配置了ASCEND_PROCESS_LOG_PATH或ASCEND_WORK_PATH环境变量，则日志会落盘到指定路径下；

更多日志操作介绍请参考《日志简介》。

问题描述

问题描述

HixlCSServer::RegisterMem 会依次向所有匹配的 Endpoint 注册同一块内存。当前实现中，如果前一个 Endpoint 注册成功，而后续 Endpoint 注册失败，HIXL_CHK_STATUS_RET 会直接返回错误，但此前已成功完成的 Endpoint 注册不会被注销或回滚。

相关代码路径

• src/hixl/cs/hixl_cs_server.cc
• HixlCSServer::RegisterMem
• 失败返回点位于调用 endpoint->RegisterMem(...) 的循环内部

实际行为

接口返回失败，但底层仍保留部分成功注册状态。第一个 Endpoint 的注册句柄只存在于 HixlCSServer::RegisterMem 的局部 ep_mem_infos 中。由于函数在写入服务端 reg_mems_ 之前已经返回，调用方无法获得可用于 HixlCSServerUnregMem 的聚合句柄，因此无法通过正常公开接口清理这部分注册。

环境信息

HIXL 版本

• 仓库：cann/hixl
• Commit：884aad902480132a9ef3aadc73690e9fc53e590b

操作系统

Linux autodl-container-784e4d9ede-d72c02b7 5.4.0-144-generic
#161-Ubuntu SMP Fri Feb 3 14:49:04 UTC 2023 x86_64 GNU/Linux

编译环境

GCC:
gcc (Ubuntu 11.3.0-1ubuntu1~22.04) 11.3.0

CMake:
cmake version 4.1.3

重现步骤

1. 检出被测试版本

git checkout 884aad902480132a9ef3aadc73690e9fc53e590b

2. 应用复现测试补丁

修改以下 3 个测试相关文件：

tests/depends/hccl/src/hccl_stub.h
tests/depends/hccl/src/hccl_stub.cc
tests/cpp/hixl/cs/test_hixl_cs_server.cc

补丁内容包括：

1. 为 HCCL Stub 增加 SetMemRegFailureOnCall，允许指定第 N 次
   HcommMemReg 返回指定错误；
2. 统计 HcommMemReg 和 HcommMemUnreg 的调用次数；
3. 统计当前仍处于注册状态的 Stub 句柄数量；
4. 新增测试：

HixlCSTest.RegisterMemRollsBackEarlierEndpointsWhenLaterEndpointFails

测试创建两个 Host UBC_CTP Endpoint，并执行：

SetMemRegFailureOnCall(2U, HCCL_E_INTERNAL);

即：

• 第一次 HcommMemReg 正常成功；
• 第二次 HcommMemReg 返回 HCCL_E_INTERNAL。

随后调用 HixlCSServerRegMem，并检查：

EXPECT_EQ(GetMemRegCallCount(), 2U);
EXPECT_EQ(GetMemUnregCallCount(), 1U);
EXPECT_EQ(GetActiveMemRegCount(), 0U);

3. 加载 CANN 环境并运行 HIXL C++ Suite

source /usr/local/Ascend/cann/set_env.sh
bash tests/run_test.sh -t cpp -s hixl

测试目标能够正常构建，但新增测试失败。Suite 的退出码为 1，唯一失败项为：

HixlCSTest.RegisterMemRollsBackEarlierEndpointsWhenLaterEndpointFails

4. 定向运行复现测试

./build_test/tests/cpp/hixl/hixl_test \
  --gtest_filter=HixlCSTest.RegisterMemRollsBackEarlierEndpointsWhenLaterEndpointFails

连续执行 3 次，三次结果完全一致：

问题可以稳定复现。

预期结果

RegisterMem 应保证失败原子性：任一 Endpoint 注册失败时，应回滚本次已成功注册的所有 Endpoint，确保接口返回失败后不残留注册状态；如果设计上无法回滚，则应返回可供调用方清理的句柄或信息。

日志 / 截图

实际失败日志

[ RUN      ] HixlCSTest.RegisterMemRollsBackEarlierEndpointsWhenLaterEndpointFails
[ERROR] GE(9052,ut):2026-09-16-18:29:06.931.080 [endpoint.cc:205][HIXL] 9052 RegisterMem: ErrorNo: 503900 Call api:HcommMemReg failed, ret:4, ep_handle:0xe, addr:0x55ff14acdb40, size:4 bytes
[ERROR] GE(9052,ut):2026-09-16-18:29:06.931.092 [hixl_cs_server.cc:346][HIXL] 9052 RegisterMem: ErrorNo: 503900 Failed to register mem.
[ERROR] GE(9052,ut):2026-09-16-18:29:06.931.097 [hixl_cs.cc:101][HIXL] 9052 HixlCSServerRegMem: ErrorNo: 503900 Failed to register server mem
test_hixl_cs_server.cc:296: Failure
Expected equality of these values:
  GetMemUnregCallCount()
    Which is: 0
  1U
    Which is: 1

test_hixl_cs_server.cc:297: Failure
Expected equality of these values:
  GetActiveMemRegCount()
    Which is: 1
  0U
    Which is: 0

[  FAILED  ] HixlCSTest.RegisterMemRollsBackEarlierEndpointsWhenLaterEndpointFails (0 ms)

日志证明：

1. 第二次 Endpoint 注册按照测试配置失败；
2. 第一次成功注册没有调用 HcommMemUnreg，实际注销次数为 0；
3. 接口返回失败后仍有一个活跃注册句柄；
4. 该问题连续运行 3 次均得到相同结果。

附件

04be92372b8a4ca3bac1a9ba8038df67.log
86b4fe138de7406895ef3dd39c692105.log

备注