租户端 互联网中间件 消息队列 RocektMQ 版 SDK文档

SDK 概述

最近更新时间: 2026-06-30 15:06:00

消息队列 RocketMQ 版是由云平台独立维护的代码分支且 100% 兼容 RocketMQ 协议的消息队列，具备高性能、高可用、高可靠、高弹性、高安全等特征。本文主要介绍 RocketMQ 集群不同版本 SDK 的兼容性说明，以及使用客户端收发消息前连接信息的收集，例如获取集群的接入点、访问集群的角色和密钥等。

兼容性说明

RocketMQ 5.0 提供了全新的基于 gRPC 协议的 5.x SDK，新版本 SDK 更加轻量化，多语言支持更好，建议优先使用。同时，消息队列 RocketMQ 版 5.x 系列也支持存量业务继续使用 4.x SDK 访问，兼容性说明如下：

服务端版本客户端版本兼容性
5.x5.x SDK完全兼容
4.x SDK版本 >= 4.9.5
  • PushConsumer CONSUME_FROM_TIMESTAMP 暂不生效（控制台可以重置位点）。
  • 消费者 setPullBatchSize 最大值为 32（服务端会最终限制为 32）。
版本 < 4.9.5
  • PushConsumer CONSUME_FROM_TIMESTAMP 暂不生效（控制台可以重置位点）。
  • 消费者 setPullBatchSize 最大值为 32（服务端会最终限制为 32）。
  • PullConsumer 消费暂不支持。

客户端网络环境说明

客户端可通过以下三种网络方式连接并访问 RocketMQ 集群：

  1. 云内网络访问
    客户端部署在当前云平台内部，网络默认互通，可以直接使用 VPC 网络接入点访问。
  2. 云外网络访问
    客户端部署在当前云平台外部，由于网络隔离，无法直接通信。若需要跨网通信，可以咨询运维使用云外接入点

获取连接信息

以下连接信息均需登录 TDMQ RocketMQ 版控制台获取。

  1. 集群接入点地址和端口信息。
    在集群基本信息页面的接入信息模块获取，根据网络类型的不同选择不同的接入点。
    4.x
    在控制台的 命名空间 列表页面获取。

    5.x
    集群基本信息 页面获取

  1. 访问集群的角色和密钥，需确保该用户已拥有相应的访问权限。
    在控制台的**集群权限（5.x 集群）或者角色管理（4.x 集群）**页面获取。

  2. Topic 名称。
    在控制台的 Topic 列表页面获取。

  3. Group 名称。
    在控制台的 Group列表页面获取。