首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >顺序消费失败会堵住整条队列:本地重试与死信退出

顺序消费失败会堵住整条队列:本地重试与死信退出

原创
作者头像
一只特立独行的兔先生
发布于 2026-11-19 21:19:57
发布于 2026-11-19 21:19:57
100
举报

支付处理失败后,同一订单后面的发货没有被别的消费者接走,这条队列停住。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 秒

阻塞到成功或进死信

-1 时近似无限

gRPC 普通 Push

改不可见时间

不阻塞

retryMaxTimes 默认 16

gRPC 顺序 Push

本地延迟后再调 listener

阻塞到成功或进死信

默认 16,不是无限

最大投递次数 = 首次 1 次 + 最大重试次数。

控制台上的次数改不到 Remoting

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 决定,短于处理时间会被提前重投。

代码语言:java
复制
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,中途失败会整批再挂起。

分区键决定一条失败挡住谁

代码语言:java
复制
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 同时设置。消费组仍要选顺序投递。

代码语言:java
复制
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 失败、写库后崩溃、重平衡、不可见时间过短,仍会重复投递。顺序消费不免幂等。

代码语言:java
复制
.setMessageListener(messageView -> {
    try {
        handle(messageView.getBody());
        return ConsumeResult.SUCCESS;
    } catch (RuntimeException e) {
        return ConsumeResult.FAILURE;
    }
})

这段接在 newPushConsumerBuilder() 上。getBody() 返回只读 ByteBuffer。次数和间隔改消费组。关掉「开启消费」可以止血,不会把失败消息从队列头拿掉。

用同键三条消息看有没有被越过

同一订单发创建、支付、发货,支付固定抛异常。Remoting 先把 setMaxReconsumeTimes 设为 2,挂起保持 1000,验完再改回线上值。

  • 三条的 queueId 必须相同。不同就是选队列错了,验证无效。
  • 次数用尽前不能打印发货。打印了,就是没走顺序监听,或失败后仍返回成功。
  • 用尽后,死信查询能按该 Group 看到支付,然后发货才出现。死信没有、发货也不出现,多半还在近似无限重试,或查错 Group。

gRPC 没有这套 queueId。看同一 message group 下发货是否提前出现,再用死信查询核对。Remoting 顺序失败默认不进 delay level,重试查询页可以是空的。5.x 查重试要选 Group,4.x 不填。有 Key 就按 order-10001 精确查。

5.x 同时看堆积 RocketmqNamespaceConsumerLagMessages、滞后 RocketmqNamespaceConsumerLagLatency(毫秒)、死信 RocketmqNamespaceSendToDlqMessagesTotal。挂起时前两个上升,死信等次数用尽。这三个名字不要套到 4.x。换一个订单号,另一条队列应继续。全部停住,就查分区键是不是常量,以及消费开关是否被关。

上线前对一下

  • 集群消费、顺序投递,不开广播。分区键用订单号这一类细键,队列数不跟普通扩容一起改。
  • Remoting 显式 setMaxReconsumeTimes。gRPC PushConsumer 的次数以消费组为准。顺序只配固定间隔,10 到 1800 秒。
  • 4.x 虚拟集群和专享集群的名字带 命名空间%名称。接入地址抄控制台。挂起时间按 10 到 30000 毫秒理解。
  • 死信 3 天内处理,重发前先修逻辑。补偿和消费都按订单号加状态版本幂等。告警覆盖堆积、滞后和死信,不只看重试页。

参考文档:

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 挂住的是队列,不是这一条消息
  • 控制台上的次数改不到 Remoting
  • 分区键决定一条失败挡住谁
  • 进死信才能继续,先后已经断了
  • 用同键三条消息看有没有被越过
  • 上线前对一下
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档