支付处理失败后,同一订单后面的发货没有被别的消费者接走,这条队列停住。TDMQ RocketMQ 顺序消费里,失败消息不让出当前队列。给同一个 Group 加实例只能分担其他队列,跳不过这条消息。
顺序消息按 ShardingKey 进同一队列,由该队列的消费线程串行处理。腾讯云不支持新建单队列的全局顺序,已有的可以继续用。要全局有序,只能让全部消息共用一个 ShardingKey。
只有集群消费会自动重试。广播失败不重试,也不会挂住队列。顺序 Group 不要开广播,否则失败被直接丢掉。
Remoting 的 MessageListenerOrderly 失败时返回 ConsumeOrderlyStatus.SUSPEND_CURRENT_QUEUE_A_MOMENT。消息放回当前 ProcessQueue,不进服务端 delay level。挂起默认 suspendCurrentQueueTimeMillis = 1000 毫秒,调度限制在 10 到 30000 毫秒。设成 60000 仍会被夹到 30 秒。消费者和当次上下文都能改这个值。
并发消费返回 ConsumeConcurrentlyStatus.RECONSUME_LATER 才走服务端重试,同队列其他消息继续。SDK 第一次 delayLevel 为 3,第 1 次间隔 10 秒,第 2 次 30 秒,第 16 次 2 小时。顺序消费不走这张表。
gRPC 普通消息失败后调用 ChangeInvisibleDuration,到期再投。顺序消息优先在客户端本地延迟后再次调用 listener,达到 maxAttempts 才 ForwardMessageToDeadLetterQueue。本地重试期间,同队列后续消息出不去。
路径 | 失败后 | 后续消息 | 默认次数 |
|---|---|---|---|
Remoting 并发 | 服务端 delay level | 不阻塞 | 重试 16 次,最多投递 17 次 |
Remoting 顺序 | 本地挂起,约 1 秒 | 阻塞到成功或进死信 |
|
gRPC 普通 Push | 改不可见时间 | 不阻塞 |
|
gRPC 顺序 Push | 本地延迟后再调 listener | 阻塞到成功或进死信 | 默认 16,不是无限 |
最大投递次数 = 首次 1 次 + 最大重试次数。
5.x 控制台的重试策略和最大重试次数,只对 gRPC PushConsumer 生效。Remoting、SimpleConsumer,以及 5.x 上的 4.x 客户端,都以 setMaxReconsumeTimes 为准。4.x 的 Group 页面没有这组参数。
代码不设时,顺序消费的 maxReconsumeTimes = -1,近似 Integer.MAX_VALUE。控制台填 3 不会生效,失败消息按大约 1 秒一次挂住队列。
gRPC 顺序消费不是无限重试。默认 retryMaxTimes = 16,Proxy 下发 maxAttempts = retryMaxTimes + 1。顺序投递只能选固定间隔,10 到 1800 秒,不能选阶梯退避。阶梯从 10 秒拉到 2 小时,为了保序会把消费卡住。固定间隔也只对 PushConsumer 生效。SimpleConsumer 的下次可见时间由 invisibleDuration 或 changeInvisibleDuration 决定,短于处理时间会被提前重投。
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer(
"GID_order",
new AclClientRPCHook(new SessionCredentials("accessKey", "secretKey")));
consumer.setNamesrvAddr("rmq-example.rocketmq.example.com:8080");
consumer.subscribe("order_topic", "*");
consumer.setMaxReconsumeTimes(16);
consumer.setSuspendCurrentQueueTimeMillis(1000);
consumer.registerMessageListener((MessageListenerOrderly) (msgs, context) -> {
context.setAutoCommit(true);
for (MessageExt msg : msgs) {
System.out.printf("queueId=%d reconsumeTimes=%d msgId=%s%n",
msg.getQueueId(), msg.getReconsumeTimes(), msg.getMsgId());
try {
handle(msg.getBody());
} catch (RuntimeException e) {
return ConsumeOrderlyStatus.SUSPEND_CURRENT_QUEUE_A_MOMENT;
}
}
return ConsumeOrderlyStatus.SUCCESS;
});
consumer.start();接入地址抄控制台。端口说明里 5.x TCP 是 8080,4.x TCP 是 9876,4.x HTTP 是 5576;5.x 快速入门示例写成 8081,以控制台为准。4.x 虚拟集群和专享集群的 Topic、Group 要写成 命名空间%名称。Remoting 依赖 rocketmq-client 与 rocketmq-acl,不低于 4.9.4。
handle 失败必须抛出。捕获后返回 SUCCESS,失败消息会被提交。挂起前已写库的,下次会再写,先按订单号和状态版本判重。入参是 List,中途失败会整批再挂起。
Message msg = new Message("order_topic", "paid", "order-10001",
"paid:10001".getBytes(StandardCharsets.UTF_8));
producer.send(msg, (mqs, message, arg) -> {
int id = (Integer) arg;
if (id < 0 || mqs.isEmpty()) {
throw new IllegalArgumentException("orderId must be non-negative");
}
return mqs.get(id % mqs.size());
}, 10001);producer 是已 start() 的 DefaultMQProducer,ACL 与接入地址与消费者相同。订单号保持非负。不要用随机数或常量。商户、城市这种粗键,会让一条失败挡住该键后面的全部订单。改 Topic 队列数会改变取余落点,队列数在放量前定好。
5.x gRPC 不要把选择器拷到 newMessageBuilder()。rocketmq-client-java 用 setMessageGroup 传分区键,同一订单同一个值,且不能和 setDeliveryTimestamp 同时设置。消费组仍要选顺序投递。
provider.newMessageBuilder()
.setTopic("order_topic")
.setKeys("order-10001")
.setMessageGroup("order-10001")
.setBody("paid:10001".getBytes(StandardCharsets.UTF_8))
.build();provider 来自 ClientServiceProvider.loadService()。客户端频繁上下线、4.x 升降配、集群升级,可能短暂不保序。支付和发货仍用状态版本做条件更新。
次数用尽进入死信,当前队列才能处理后面的消息。支付进死信之后,发货会被消费。控制台重发投到原队列的重试队列,不会把支付插回已消费的发货前面。
死信按 Group 聚合该 Group 下所有 Topic。没有死信就没有这条队列。查询最多近 3 天。重发后副本不马上删,仍按 3 天清理。重发前先修消费逻辑,否则它会再次停在队列头上。
下游超时用有限次数加固定间隔。缺字段、状态非法尽快进死信。补偿不假设自己仍排在后续消息前面。ACK 失败、写库后崩溃、重平衡、不可见时间过短,仍会重复投递。顺序消费不免幂等。
.setMessageListener(messageView -> {
try {
handle(messageView.getBody());
return ConsumeResult.SUCCESS;
} catch (RuntimeException e) {
return ConsumeResult.FAILURE;
}
})这段接在 newPushConsumerBuilder() 上。getBody() 返回只读 ByteBuffer。次数和间隔改消费组。关掉「开启消费」可以止血,不会把失败消息从队列头拿掉。
同一订单发创建、支付、发货,支付固定抛异常。Remoting 先把 setMaxReconsumeTimes 设为 2,挂起保持 1000,验完再改回线上值。
queueId 必须相同。不同就是选队列错了,验证无效。gRPC 没有这套 queueId。看同一 message group 下发货是否提前出现,再用死信查询核对。Remoting 顺序失败默认不进 delay level,重试查询页可以是空的。5.x 查重试要选 Group,4.x 不填。有 Key 就按 order-10001 精确查。
5.x 同时看堆积 RocketmqNamespaceConsumerLagMessages、滞后 RocketmqNamespaceConsumerLagLatency(毫秒)、死信 RocketmqNamespaceSendToDlqMessagesTotal。挂起时前两个上升,死信等次数用尽。这三个名字不要套到 4.x。换一个订单号,另一条队列应继续。全部停住,就查分区键是不是常量,以及消费开关是否被关。
setMaxReconsumeTimes。gRPC PushConsumer 的次数以消费组为准。顺序只配固定间隔,10 到 1800 秒。命名空间%名称。接入地址抄控制台。挂起时间按 10 到 30000 毫秒理解。参考文档:
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。