动态与公告

新功能发布记录

公告

产品简介

产品概述

什么是消息队列 RocketMQ 版

产品优势

应用场景

产品系列

开源对比

高可用

使用限制

开服地域

基本概念

产品计费

计费概述

价格说明

计费示例

切换集群计费模式（5.x）

续费说明

查看消费明细

退费说明

欠费说明

快速入门

快速入门概述

准备工作

步骤1：创建 RocketMQ 资源

步骤2：使用 SDK 收发消息（推荐）

步骤2：运行 RocketMQ 客户端（可选）

步骤3：查询消息

步骤4：销毁资源

用户指南

使用流程指引

配置账号权限

新建集群

命名空间管理

配置 Topic

配置 Group

连接集群

管理消息

管理集群

查看监控和配置告警

跨集群复制消息

实践教程

RocketMQ 常见概念命名规范

RocketMQ 客户端实践

RocketMQ 性能压测和容量评估

使用社区版 HTTP SDK 接入

客户端风险说明和更新指南

关于 RocketMQ 4.x 集群角色（Role）相关云 API 迁移指引

迁移指南

有感迁移

无感迁移

开发指南

消息类型

消息过滤

消息重试

POP 消费模式（5.x）

集群消费与广播消费

订阅关系一致性

限流

API 参考（5.x）

History

API Category

Making API Requests

Topic APIs

Consumer Group APIs

Message APIs

Role Authentication APIs

Hitless Migration APIs

Cloud Migration APIs

Cluster APIs

Data Types

Error Codes

API 参考（4.x）

SDK 参考

SDK 概述

5.x SDK

4.x SDK

安全与合规

权限管理

云 API 审计

删除保护

常见问题

4.x 实例常见问题

服务协议

服务等级协议

联系我们

SDK 概述

PDF

聚焦模式

字号

最后更新时间： 2026-03-18 15:33:52

消息队列 RocketMQ 版是由腾讯云独立维护的代码分支且 100% 兼容 RocketMQ 协议的消息队列，具备高性能、高可用、高可靠、高弹性、高安全等特征。本文主要介绍 RocketMQ 集群不同版本 SDK 的兼容性说明，以及使用客户端收发消息前连接信息的收集，例如获取集群的接入点、访问集群的角色和密钥等。
各版本 SDK 说明
腾讯云消息队列 RocketMQ 版各版本 SDK 和功能支持情况如下表所示，✓ 表示支持该功能，× 表示暂不支持该功能。一般为客户端能力不支持。
对比项
RocketMQ 5.x gRPC SDK
RocketMQ 5.x Remoting SDK
RocketMQ 4.x/3.x SDK
RocketMQ TCP 1.x SDK
RocketMQ HTTP SDK
协议
gRPC 协议
Remoting 协议
Remoting 协议
Remoting 协议
HTTP 协议
可访问的集群类型
5.x 系列
5.x 系列
4.x 系列
5.x 系列
4.x 系列
5.x 系列
4.x 系列
5.x 系列
4.x 系列
使用建议
推荐 5.x gRPC SDK。
多语言支持完善。
新的功能和优化社区将会在 5.x gRPC SDK 上得到支持。
如果 5.x gRPC SDK 的某些功能不能满足需求，则可以考虑使用 5.x Remoting SDK。比如一些 PushConsumer 在部分语言上不支持。
﻿
原业务已使用这些版本的客户端可继续正常使用。
5.x系列实例兼容这些版本的 SDK。
﻿
在专线场景下，需要使用 5.x 系列，其他场景可自选。
普通、顺序、定时消息的发送功能
✓
✓
✓
✓
✓
事务消息
✓
✓
✓
✓
×
消息轨迹
✓
✓
4.5.2及以上版本支持
✓
✓
并发消费
✓
✓
✓
✓
✓
顺序消费
✓
✓
✓
✓
✓
广播消费
×
✓
✓
✓
×
流式消费（如Flink 等）
×
✓
✓
×
×
客户端Metrics 指标数据
✓
×
×
×
×
批量发送
×
✓
✓
×
×
备注：总体而言，JAVA 和 GO 的版本是最完善的，同时 HTTP SDK 也使用广泛。
JAVA 客户端兼容性说明
RocketMQ 5.0 提供了全新的基于 gRPC 协议的 5.x SDK，新版本 SDK 更加轻量化，多语言支持更好，建议优先使用。同时，消息队列 RocketMQ 版 5.x 系列也支持存量业务继续使用 4.x SDK 访问，对使用量最大的 JAVA 客户端的 兼容性说明如下：
服务端版本
客户端版本
﻿
兼容性
5.x
5.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 网络直接访问
客户端和 RocketMQ 集群部署在同一个私有网络 VPC 内，网络默认互通，可以直接使用 VPC 网络接入点访问。
2. 不同 VPC 网络通过云联网通信
客户端和 RocketMQ 集群部署在不同的私有网络 VPC 内，由于 VPC 之间逻辑隔离，无法直接通信。若需要跨网通信，可以使用云联网实现同账号下不同地域间的 VPC 互通。
3. 公网访问
客户端部署在其他网络环境，或者与 RocketMQ 集群在不同的地域，可以开通一条公网路由，通过公网接入点访问。
更多关于网络环境的介绍请参考网络连接说明。
获取连接信息
以下连接信息均需登录 TDMQ RocketMQ 版控制台获取。
1. 集群接入点地址和端口信息。
在集群基本信息页面的接入信息模块获取，根据网络类型的不同选择不同的接入点。
﻿
2. 命名空间的名称（仅 4.x 专享集群和虚拟集群需要填写）。
在控制台的命名空间列表页面获取。
﻿
3. 访问集群的角色和密钥，需确保该用户已拥有相应的访问权限。
在控制台的集群权限（5.x 集群）或者角色管理（4.x 集群）页面获取。
﻿
4. Topic 名称。
在控制台的 Topic 列表页面获取。
﻿
5. Group 名称。
在控制台的 Group 列表页面获取。

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

对比项	RocketMQ 5.x gRPC SDK	RocketMQ 5.x Remoting SDK	RocketMQ 4.x/3.x SDK	RocketMQ TCP 1.x SDK	RocketMQ HTTP SDK
协议	gRPC 协议	Remoting 协议	Remoting 协议	Remoting 协议	HTTP 协议
可访问的集群类型	5.x 系列	5.x 系列 4.x 系列	5.x 系列 4.x 系列	5.x 系列 4.x 系列	5.x 系列 4.x 系列
使用建议	推荐 5.x gRPC SDK。多语言支持完善。新的功能和优化社区将会在 5.x gRPC SDK 上得到支持。如果 5.x gRPC SDK 的某些功能不能满足需求，则可以考虑使用 5.x Remoting SDK。比如一些 PushConsumer 在部分语言上不支持。			原业务已使用这些版本的客户端可继续正常使用。 5.x系列实例兼容这些版本的 SDK。		在专线场景下，需要使用 5.x 系列，其他场景可自选。
普通、顺序、定时消息的发送功能	✓	✓	✓	✓	✓
事务消息	✓	✓	✓	✓	×
消息轨迹	✓	✓	4.5.2及以上版本支持	✓	✓
并发消费	✓	✓	✓	✓	✓
顺序消费	✓	✓	✓	✓	✓
广播消费	×	✓	✓	✓	×
流式消费（如Flink 等）	×	✓	✓	×	×
客户端Metrics 指标数据	✓	×	×	×	×
批量发送	×	✓	✓	×	×

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

tencent cloud

消息队列 RocketMQ 版

SDK 概述

各版本 SDK 说明

JAVA 客户端兼容性说明

客户端网络环境说明

获取连接信息

帮助和支持