文档中心>消息队列 RocketMQ 版>实践教程>客户端风险说明和更新指南

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

最近更新时间:2025-06-10 16:17:03

我的收藏

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,直接升级依赖版本即可。