tencent cloud

消息队列 RocketMQ 版

动态与公告
新功能发布记录
公告
产品简介
产品概述
什么是消息队列 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 实例常见问题
服务协议
服务等级协议
联系我们
文档消息队列 RocketMQ 版实践教程客户端风险说明和更新指南

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

PDF
聚焦模式
字号
最后更新时间: 2026-01-23 17:02:15

1. Java 的 PushConsumer 顺序消息在特定场景下无法保证顺序

客户端列表

5.0.6及以下版本在一些特殊场景下可能会遇到这个问题,在一些网络异常、超时等的场景下,无法保证消息顺序。相关问题:[Bug] PushConsumer reentrant pop orderly doesn't work as expected

升级客户端操作指南

建议升级到5.0.7,直接升级依赖版本即可。

2. golang 版本低,路由表可能被清空

客户端列表

v5.0.1及以下在一些网络超时的场景下,由于获取不到路由表,进行了路由表清空,相关问题:golang: optimize the logic of obtaining routing tasks

升级客户端操作指南

建议升级到v5.1.1-rc1,直接升级依赖版本即可。

3. Java 消息轨迹可能不完整

客户端列表

4.9.4及以下在一些特殊场景下可能会遇到。

升级客户端操作指南

建议升级到4.9.5,直接升级依赖版本即可。

4. Go SDK 首次启动可能报错 fetch offset of mq from broker error

客户端列表

master 分支之下都可能遇到,比如 v2.1.2 及以下,启动报错 fetch offset of mq from broker error

升级客户端操作指南

建议升级到最新的 master branch 作为 Commit ID 版本即可。

5. Java SDK 消费过程中出现报错 the queue's messages, span too long, so do flow control

客户端列表

4.7.1及以下在一些特殊场景下可能会遇到,在消费过程中,日志中打印如上日志,并且消费会被限流。

升级客户端操作指南

建议升级到4.9.5,直接升级依赖版本即可。



帮助和支持

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

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

文档反馈