云消息队列 RocketMQ 版：自助问题排查

异常问题

处理建议

日志中存在未收录的日志

以下日志未被诊断系统收录，请提交工单咨询。

签名算法未找到

请检查JDK和操作系统版本，以及是否存在依赖冲突。

消费异常

请检查消费端代码或提交工单咨询。

如需进一步定位消费端问题，请参考以下高频子场景：

场景 1：消息未被消费 / 控制台显示"处理中"但客户端无日志

建议在消费入口处添加打印 Message ID 的日志，确认消息是否已到达客户端。若控制台无消息轨迹且客户端也无相关日志，重点排查客户端订阅配置和接收环节是否正常。

场景 2：顺序消息卡住 / 手动 ACK 无效

顺序消息具有单队列串行消费的特性，一条消息处理卡住会阻塞该队列后续所有消息的消费。服务端不支持从控制台手动跳过或 ACK 顺序消息，需自行排查消费端业务逻辑是否存在耗时过长或死锁问题。

场景 3：顺序消息重复拉取

顺序消息重复拉取通常由消费端处理失败触发：消费逻辑抛出异常或未在超时时间内返回 ACK，客户端会自动重试。建议检查本地客户端日志（默认路径：/{user.home}/logs/rocketmq/rocketmq-client.log），确认是否存在消费失败记录；同时排查客户端所在机器的性能指标（CPU、内存、Full GC 等），避免因机器性能波动导致消费超时。

场景 4：consumeTimeout 参数不生效

请核对当前使用的 SDK 版本是否支持 consumeTimeout 配置，并确认参数数值是否符合该版本的取值规范（单位、取值范围等）。不同版本 SDK 对此参数的支持情况存在差异。

心跳发送失败

请检查 Topic、Group 资源是否创建。如果伴随网络/后端服务异常，处理建议参考网络/后端服务异常，或提交工单咨询。

消费确认失败

如果伴随网络/后端服务异常，处理建议参考网络/后端服务异常，或提交工单咨询。

消息拉取失败

请检查 Topic、Group 资源是否创建。如果伴随网络/后端服务异常，处理建议参考网络/后端服务异常，或提交工单咨询。

消息发送失败

请检查 Topic 资源是否创建。如果伴随网络/后端服务异常，处理建议参考网络/后端服务异常。若报错与客户端代码相关，请参考以下常见场景排查：

场景 1：频繁创建 Producer 实例

若报错日志包含 checkCurrentState 或出现连接超时，原因可能是代码在重试循环或其他高频路径内重复调用 buildProducer() 创建新 Producer 实例。Producer 是重量级对象，应在应用启动时创建单例，整个生命周期内复用，避免频繁创建和销毁。请确保应用完成初始化后再开始发送消息。

场景 2：ONSClientException 报错（Namespace 参数缺失或错误）

除检查安全组端口、MQ 白名单和使用 telnet 测试网络连通性外，还需确认代码中是否正确设置了 Namespace 参数，例如：properties.setProperty(PropertyKeyConst.Namespace, "实例ID");。若 Namespace 参数缺失或填写错误，即使网络连通也会触发此异常。

若以上排查均未解决问题，提交工单咨询。

获取路由失败

请检查 Topic 资源是否创建。如果伴随网络/后端服务异常，处理建议参考网络/后端服务异常，或提交工单咨询。

客户端下线失败

如果伴随网络/后端服务异常，处理建议参考网络/后端服务异常。若发生在应用进程终止时，可忽略。

触发服务端限流

登录云消息队列 RocketMQ 版控制台，可通过查看实例仪表盘中的生产/消费TPS水位及被限流请求次数对实例的规格进行升配。升降配请参见实例升降配。

消费 group 信息未找到

请检查客户端订阅时采用的Group是否已创建。登录云消息队列 RocketMQ 版控制台，在实例列表页面单击客户端访问的实例名称，然后在Group 管理页面查询客户端订阅时采用的Group是否存在。

AK 不合法

请检查客户端中，认证信息是否正确。

• 5.x版本实例

  实例用户名，在云消息队列 RocketMQ 版控制台访问控制的智能身份识别页签中获取。

• 4.x版本实例

  AccessKey ID，阿里云身份验证标识。获取方式，请参见创建AccessKey。

SK 不合法

请检查客户端中，认证信息是否正确。

• 5.x版本实例

  实例密码，在云消息队列 RocketMQ 版控制台访问控制的智能身份识别页签中获取。

• 4.x版本实例

  AccessKey Secret，阿里云身份验证密钥。获取方式，请参见创建AccessKey。

非法的定时消息时长

调整定时消息时长或升级实例的版本，实例的定时消息间隔时长请参见配额与限制。

非法的消息属性

请根据错误日志，检查消息属性是否存在冲突。消息属性，请参见消息内部属性。

消息类型不匹配

请检查控制台Topic消息类型与实际代码中发送的消息类型是否匹配。

本地消息缓存满

消费处理速度太慢，请检查消费逻辑。

网络错误

网络异常，详情请提交工单咨询。

无在线消费端

登录云消息队列 RocketMQ 版控制台，在实例列表页面单击客户端访问的实例名称，然后在Group 管理页面单击客户端使用的Group ID。

• 5.x版本实例

  在Group 详情页面单击运行信息页签，在客户端连接区域，查看是否存在对应的客户端。并自行检查客户端消费状态是否正常。

• 4.x版本实例

  在客户端连接信息区域，查看是否存在对应的客户端。并自行检查客户端消费状态是否正常。

本地请求丢失

可能的原因：

1. 客户端异常卡住，例如发生Full GC。

2. 网络问题导致重复传输，偶发可忽略。

后端服务异常

服务端异常，详情请提交工单咨询。

订阅关系不一致

登录云消息队列 RocketMQ 版控制台，在实例列表页面单击客户端访问的实例名称，然后在Group 管理页面单击客户端使用的Group ID，在Group 详情页面订阅关系区域查看是否存在不一致的订阅关系。确保Topic主题的订阅关系一致。订阅关系一致性的说明，请参见订阅关系（Subscription）。

订阅关系不存在

请检查消费端是否在线，以及网络是否正常。

topic 未找到

请检查客户端发送/订阅的Topic是否已创建。登录云消息队列 RocketMQ 版控制台，在实例列表页面单击客户端访问的实例名称，然后在Topic 管理页面查询客户端访问的Topic是否存在。

请求码不支持

常见code 320，不支持批量消息。

检查项

异常问题

处理建议

实例检查

实例不存在

请检查实例名称。

实例不在运行状态

请检查实例状态。

Topic检查

topic 不存在

请检查Topic资源是否在控制台创建。

服务端检查

服务端机器宕机

后端物理服务器集群中单台机器发生宕机，可能导致短时间网络报错，可忽略。

服务端发布更新

后端服务器集群存在运维操作，可能导致秒级别网络闪断，客户端日志可见短时间网络报错，可忽略。若未提前收到运维通知，请提交工单咨询。