消息队列 / 系统课时
Spring 消费重试
Spring 消费重试
消费失败时最危险的做法不是“没有重试”,而是让消息在 broker 与消费者之间无限重投。本节配置有限次数重试、指数退避和最终恢复器,使短暂故障获得再次执行机会,同时让永久失败消息在达到上限后明确退出主消费链路。
学习目标
- 配置消费端有限次数重试与退避间隔
- 区分“监听器内重试”与 RabbitMQ 重新入队
- 使用
MessageRecoverer处理重试耗尽后的消息
重试发生在一次消费交付内部
Spring 的监听重试会在监听方法抛出异常后再次调用业务处理,而不是每次都先把消息重新放回 RabbitMQ 队尾。只有重试最终耗尽后,恢复器或容器的拒绝策略才决定这条消息是丢弃、拒绝、重新入队还是转发到错误通道。

这种方式适合数据库短暂超时、下游服务瞬时失败等可恢复异常。对于参数格式错误、业务规则永久不满足等确定性失败,重复执行通常没有价值,应尽快进入恢复流程,而不是单纯拉大重试次数。
配置有限次数和指数退避
以下配置以 Spring Boot 4.x 的属性名为例。max-retries: 2 表示首次调用失败后最多再重试 2 次,因此同一条消息最多执行 3 次;退避从 1 秒开始,乘数为 2,并受 5 秒上限约束。
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:重试耗尽后拒绝消息且不重新入队,从而结束无限循环。
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();
}
}预期结果
应用启动后注册 MessageRecoverer;监听重试耗尽时,当前消息被拒绝且不重新入队。这是完整的 Spring 配置类,但它依赖项目已经引入 RabbitMQ starter 并启用了默认监听容器工厂。若原队列配置了 DLX,被拒绝消息会由 broker 路由到死信队列;没有 DLX 时消息会被丢弃,因此恢复策略必须和队列拓扑一起设计。
如果希望把失败原因、原交换机和路由键附加到一条“错误消息”后主动转发,可以改用 RepublishMessageRecoverer。它与 broker 死信是两种不同路径:前者由应用重新发布,后者由 broker 在拒绝后转发,生产设计中应明确选择而不是叠加到无法解释的链路里。
判断哪些异常值得重试
重试策略应围绕“下一次执行是否可能成功”来设计。连接抖动、临时限流、可恢复的锁等待通常适合有限重试;反序列化错误、缺少必填字段、违反不可变业务规则,重复执行大概率只会浪费消费者线程。
对会调用外部系统的监听器还必须考虑幂等。一次业务处理可能已经写库成功,却在确认消息前连接中断;RabbitMQ 随后重新投递时,业务代码必须能识别重复请求,否则“可靠消费”会变成重复扣款、重复发券或重复写入。
验证重试不会无限进行
在测试环境发送一条必然让监听器抛异常的消息,并记录监听方法的调用次数。按上面的配置,同一条消息最多进入监听方法 3 次,之后由恢复器拒绝且不重新入队;若配置 DLX,则再检查死信队列是否增加 1 条。
可以同时观察主队列状态,确认消息没有持续回流:
rabbitmqctl list_queues -p / name messages_ready messages_unacknowledged预期结果
name messages_ready messages_unacknowledged
<QUEUE> 0 0<QUEUE> 为测试主队列名。若该消息仍反复出现,优先检查是否关闭了监听重试却保留默认 requeue、是否有自定义异常处理器强制重新入队,或是否存在 DLQ 过期后自动回流主队列的 broker 策略。有限重试的验收标准不是“最终一定成功”,而是失败路径有明确上限和明确归宿。