關於4.x系列執行個體的非Region化存取點下線及升級公告 - ApsaraMQ for RocketMQ

為了進一步提升雲訊息佇列 RocketMQ 版服務的穩定性，針對部分使用非Region化存取點訪問4.x系列執行個體的訪問進行統一升級，通過改為使用Region化存取點訪問服務，提升訊息生產消費鏈路的穩定性。

下線時間

北京時間 2026年5月15日，請務必在下線時間之前升級生產者和消費者存取點配置。

變更影響

影響範圍：訪問RocketMQ 4.x系列執行個體服務的存取點網域名稱沒有包含地區ID，例如http://xxxx.mq-internal.aliyuncs.com:8080 。
影響結果：存取點下線後，所有使用非Region化網域名稱訪問服務的訊息生產消費請求都會失敗。

升級方案

查看非Region化存取點訪問資訊

登入雲訊息佇列 RocketMQ 版控制台。
在左側導覽列，單擊資訊查詢。
在非Region化存取點訪問資訊地區，可以查看執行個體ID、Topic的資源資訊，查看訪問這些資源的用戶端訪問IP地址。

升級存取點配置

請改用新的Region化存取點網域名稱訪問RocketMQ 4.x系列執行個體服務，操作步驟如下。

登入雲訊息佇列 RocketMQ 版控制台。
在左側導覽列，單擊執行個體列表。
在頂部功能表列，選擇地區，如華東1（杭州），然後單擊目標執行個體。
在執行個體詳情頁面，單擊接入点頁簽。
在接入点頁簽，找到TCP 協議用戶端存取點，即可查看网络為内网访问的存取點。

將該存取點配置到您發送端和訂閱端代碼的相應參數。

Java ons-client SDK

用戶端版本要求：1.8.7.4.Final 及以上版本。

修改對應的參數：ONSAddr需要修改為NAMESRV_ADDR，並修改存取點資訊：

// 請確保您的用戶端版本滿足替換存取點的要求，並將以下配置
properties.put(PropertyKeyConst.ONSAddr, "http://xxxx.mq-internal.aliyuncs.com:8080");          
// 替換為
properties.put(PropertyKeyConst.NAMESRV_ADDR, "http://xxxx.cn-hangzhou.mq-internal.aliyuncs.com:8080");

Java 開源 RocketMQ SDK

用戶端版本要求：4.5.2及以上版本

修改對應的參數：

// 如果是發送端 producer，在 producer 啟動前設定namesrv地址處變更
producer.setNamesrvAddr("http://xxxx.mq-internal.aliyuncs.com:8080");
// 替換為
producer.setNamesrvAddr("http://xxxx.cn-hangzhou.mq-internal.aliyuncs.com:8080");

// 如果是消費端 consumer，在 consumer 啟動前設定namesrv地址處變更
consumer.setNamesrvAddr("http://xxxx.mq-internal.aliyuncs.com:8080");
// 替換為
consumer.setNamesrvAddr("http://xxxx.cn-hangzhou.mq-internal.aliyuncs.com:8080");

C/C++ SDK

用戶端版本要求：1.1.0及以上版本

修改對應的參數：修改存取點（如有），如果使用ONSFactory.getInstance()進行初始化，檢查ONSFactoryProperty中存取點的設定。

如果之前使用SDK的ONSAddr配置方式，需要修改為NAMESRV_ADDR，並修改存取點資訊：

// 如果是發送端 producer或者consumer，設定的存取點
factoryInfo.setFactoryProperty(ONSFactoryProperty::ONSAddr, "http://XXX.mq-internal.aliyuncs.com:8080");
// 替換為
factoryInfo.setFactoryProperty(ONSFactoryProperty::NAMESRV_ADDR, "http://MQ_INST_XXXXXXXXXXX.cn-hangzhou.mq-internal.aliyuncs.com:8080");

如果之前使用NAMESRV_ADDR配置方式，需要修改存取點資訊：

// 如果是發送端 producer或者consumer，設定的存取點
factoryInfo.setFactoryProperty(ONSFactoryProperty::NAMESRV_ADDR, "http://MQ_INST_XXXXXXXXXXX.mq-internal.aliyuncs.com:8080");
// 替換為
factoryInfo.setFactoryProperty(ONSFactoryProperty::NAMESRV_ADDR, "http://MQ_INST_XXXXXXXXXXX.cn-hangzhou.mq-internal.aliyuncs.com:8080");

.NET SDK

用戶端版本要求：1.1.0及以上版本

修改對應的參數：修改存取點（如有），如果使用ONSFactory.getInstance()進行初始化，檢查ONSFactoryProperty中存取點的設定。

如果之前使用SDK的ONSAddr配置方式，需要修改為NAMESRV_ADDR，並修改存取點資訊：

// 如果是發送端 producer或者consumer，設定的存取點
factoryInfo.setFactoryProperty(ONSFactoryProperty::ONSAddr, "http://XXX.mq-internal.aliyuncs.com:8080");
// 替換為
factoryInfo.setFactoryProperty(ONSFactoryProperty::NAMESRV_ADDR, "http://MQ_INST_XXXXXXXXXXX.cn-hangzhou.mq-internal.aliyuncs.com:8080");

如果之前使用NAMESRV_ADDR配置方式，需要修改存取點資訊：

// 如果是發送端 producer或者consumer使用factory初始化，設定的存取點資訊檢查是否是否需要變更
factoryInfo.setFactoryProperty(ONSFactoryProperty::NAMESRV_ADDR, "http://MQ_INST_XXXXXXXXXXX.mq-internal.aliyuncs.com:8080");
// 替換為
factoryInfo.setFactoryProperty(ONSFactoryProperty::NAMESRV_ADDR, "http://MQ_INST_XXXXXXXXXXX.cn-hangzhou.mq-internal.aliyuncs.com:8080");

背景資訊

如需使用雲訊息佇列 RocketMQ 版來收發訊息，則需在使用TCP協議下的SDK時，將相應參數配置為您實際使用的資源資訊。需特別注意的是，以下參數所對應的資源應處於同一地區：

GROUP_ID：您在雲訊息佇列 RocketMQ 版控制台上建立的Group ID。
Topic：您在雲訊息佇列 RocketMQ 版控制台上建立的Topic。
NAMESRV_ADDR：您從雲訊息佇列 RocketMQ 版控制台的執行個體詳情頁面擷取的存取點。

例如您在華東1（杭州）地區購買了一個雲訊息佇列 RocketMQ 版執行個體A，並在此地區下建立了Topic A和Group ID A，供部署在該地區的應用用戶端A使用；同時，您也在另一個地區，如華南1（深圳）購買了另一個雲訊息佇列 RocketMQ 版執行個體B，並在此地區下建立了Topic B和Group ID B，供部署在該地區的應用用戶端B使用。需特別注意的資訊如下：

針對Topic A，您只能通過在華東1（杭州）地區的、歸屬於Group ID A的用戶端A向Topic A發送或接收訊息。
針對Topic B，您只能通過在華南1（深圳）地區的、歸屬於Group ID B的用戶端B向Topic B發送或接收訊息。

具體對應關係如下圖所示。存取點設定