RocketMQTemplate消息重试机制详解

RocketMQTemplate消息重试机制详解

1. 消费者重试机制

1.1 配置重试次数

# rocketmq 配置项，对应 RocketMQProperties 配置类
rocketmq:
  name-server: 127.0.0.1:9876 # RocketMQ Namesrv
  # Producer 配置项
  producer:
    group: koala-dev-event-centre-group # 生产者分组
    send-message-timeout: 3000 # 发送消息超时时间，单位：毫秒。默认为 3000 。
    compress-message-body-threshold: 4096 # 消息压缩阀值，当消息体的大小超过该阀值后，进行消息压缩。默认为 4 * 1024B
    max-message-size: 4194304 # 消息体的最大允许大小。。默认为 4 * 1024 * 1024B
    retry-times-when-send-failed: 2 # 同步发送消息时，失败重试次数。默认为 2 次。
    retry-times-when-send-async-failed: 2 # 异步发送消息时，失败重试次数。默认为 2 次。
    retry-next-server: false # 发送消息给 Broker 时，如果发送失败，是否重试另外一台 Broker 。默认为 false
    access-key: # Access Key ，可阅读 https://github.com/apache/rocketmq/blob/master/docs/cn/acl/user_guide.md 文档
    secret-key: # Secret Key
    enable-msg-trace: true # 是否开启消息轨迹功能。默认为 true 开启。可阅读 https://github.com/apache/rocketmq/blob/master/docs/cn/msg_trace/user_guide.md 文档
    customized-trace-topic: RMQ_SYS_TRACE_TOPIC # 自定义消息轨迹的 Topic 。默认为 RMQ_SYS_TRACE_TOPIC 。

1.1.1 注意事项

1. 一条消息无论重试多少次，这些重试消息的Message ID都不会改变。
2. 消息重试只针对集群消费模式生效；广播消费模式不提供失败重试特性，即消费失败后，失败消息不再重试，继续消费新的消息

1.1.2 消息重试策略概述

RocketMQ 在消息收发过程中，若Consumer消费某条消息失败或消费超时，则生产者会在重试间隔时间后，将消息重新投递给Consumer消费，若达到最大重试次数后消息还没有成功被消费，消息将被投递至死信队列。
消息重试主要功能行为包括：

1. 重试间隔：上一次消费失败或超时后，距下次消息可被重新消费的间隔时间。
2. 最大重试次数：消息消费失败后， 生产者重复投递的最大次数。

1.2 死信队列处理

1.2.1 死信队列配置

@RocketMQMessageListener(
        topic = "topic-name",
        consumerGroup = "consumer-group-name",
        maxReconsumeTimes = 3 // 最大重试次数，默认为16
)
public class CustomConsumer implements RocketMQListener<String> {
   
   
    @Override
    public void onMessage(String message) {
   
   
        try {
   
   
            // 处理消息