消息队列 / 系统课时

Spring 消费重试

Spring 消费重试

消费失败时最危险的做法不是“没有重试”,而是让消息在 broker 与消费者之间无限重投。本节配置有限次数重试、指数退避和最终恢复器,使短暂故障获得再次执行机会,同时让永久失败消息在达到上限后明确退出主消费链路。

学习目标

  • 配置消费端有限次数重试与退避间隔
  • 区分“监听器内重试”与 RabbitMQ 重新入队
  • 使用 MessageRecoverer 处理重试耗尽后的消息

重试发生在一次消费交付内部

Spring 的监听重试会在监听方法抛出异常后再次调用业务处理,而不是每次都先把消息重新放回 RabbitMQ 队尾。只有重试最终耗尽后,恢复器或容器的拒绝策略才决定这条消息是丢弃、拒绝、重新入队还是转发到错误通道。

Spring RabbitMQ 消费重试与恢复流程

这种方式适合数据库短暂超时、下游服务瞬时失败等可恢复异常。对于参数格式错误、业务规则永久不满足等确定性失败,重复执行通常没有价值,应尽快进入恢复流程,而不是单纯拉大重试次数。

配置有限次数和指数退避

以下配置以 Spring Boot 4.x 的属性名为例。max-retries: 2 表示首次调用失败后最多再重试 2 次,因此同一条消息最多执行 3 次;退避从 1 秒开始,乘数为 2,并受 5 秒上限约束。

yaml
spring:
  rabbitmq:
    listener:
      type: simple
      simple:
        retry:
          enabled: true
          max-retries: 2
          initial-interval: 1s
          multiplier: 2.0
          max-interval: 5s
          stateless: true

生效行为是:第一次失败后约等待 1 秒再次调用,第二次仍失败后约等待 2 秒进行最后一次调用;若仍失败,重试策略进入耗尽状态。实际时间还会受到线程调度和业务执行耗时影响,不应把退避间隔当成精确计时器。

配置消息恢复器

现代 Spring Boot 会把 MessageRecoverer Bean 关联到默认监听容器工厂。最简单的恢复策略是 RejectAndDontRequeueRecoverer:重试耗尽后拒绝消息且不重新入队,从而结束无限循环。

java
package com.example.rabbitmq;

import org.springframework.amqp.rabbit.retry.MessageRecoverer;
import org.springframework.amqp.rabbit.retry.RejectAndDontRequeueRecoverer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class RabbitRetryRecoveryConfig {

    @Bean
    MessageRecoverer messageRecoverer() {
        // 重试耗尽后明确结束主队列消费,不再无限 requeue
        return new RejectAndDontRequeueRecoverer();
    }
}

预期结果

text
应用启动后注册 MessageRecoverer;监听重试耗尽时,当前消息被拒绝且不重新入队。

这是完整的 Spring 配置类,但它依赖项目已经引入 RabbitMQ starter 并启用了默认监听容器工厂。若原队列配置了 DLX,被拒绝消息会由 broker 路由到死信队列;没有 DLX 时消息会被丢弃,因此恢复策略必须和队列拓扑一起设计。

如果希望把失败原因、原交换机和路由键附加到一条“错误消息”后主动转发,可以改用 RepublishMessageRecoverer。它与 broker 死信是两种不同路径:前者由应用重新发布,后者由 broker 在拒绝后转发,生产设计中应明确选择而不是叠加到无法解释的链路里。

判断哪些异常值得重试

重试策略应围绕“下一次执行是否可能成功”来设计。连接抖动、临时限流、可恢复的锁等待通常适合有限重试;反序列化错误、缺少必填字段、违反不可变业务规则,重复执行大概率只会浪费消费者线程。

对会调用外部系统的监听器还必须考虑幂等。一次业务处理可能已经写库成功,却在确认消息前连接中断;RabbitMQ 随后重新投递时,业务代码必须能识别重复请求,否则“可靠消费”会变成重复扣款、重复发券或重复写入。

验证重试不会无限进行

在测试环境发送一条必然让监听器抛异常的消息,并记录监听方法的调用次数。按上面的配置,同一条消息最多进入监听方法 3 次,之后由恢复器拒绝且不重新入队;若配置 DLX,则再检查死信队列是否增加 1 条。

可以同时观察主队列状态,确认消息没有持续回流:

bash
rabbitmqctl list_queues -p / name messages_ready messages_unacknowledged

预期结果

text
name        messages_ready    messages_unacknowledged
<QUEUE>     0                 0

<QUEUE> 为测试主队列名。若该消息仍反复出现,优先检查是否关闭了监听重试却保留默认 requeue、是否有自定义异常处理器强制重新入队,或是否存在 DLQ 过期后自动回流主队列的 broker 策略。有限重试的验收标准不是“最终一定成功”,而是失败路径有明确上限和明确归宿。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Spring 消费重试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通