SpringBoot+RabbitMQ 死信队列
点击上方“Java基基”，选择“设为星标”
做积极的人，而不是积极废人！
每天 14:00 更新文章，每天掉亿点点头发...
源码精品专栏
原创 | Java 2021 超神之路，很肝~
中文详细注释的开源项目
RPC 框架 Dubbo 源码解析
网络应用框架 Netty 源码解析
消息中间件 RocketMQ 源码解析
数据库中间件 Sharding-JDBC 和 MyCAT 源码解析
作业调度中间件 Elastic-Job 源码解析
分布式事务中间件 TCC-Transaction 源码解析
Eureka 和 Hystrix 源码解析
Java 并发源码
来源：blog.csdn.net/m0_46144826/
article/details/120277930
前言
环境准备配置
队列达到最大长度
消息 TTL 过期
拒绝消息
前言
死信：无法被消费的消息，称为死信。
如果死信一直留在队列中，会导致一直被消费，却从不消费成功。
所以我们专门开辟了一个来存放死信的队列，叫死信队列（DLX，dead-letter-exchange）。
死信的几种来源：
消息 TTL 过期（time to live，存活时间，可以用在限时支付消息）
队列达到最大长度（队列满了，无法路由到该队列）
消息被拒绝（
basic.reject / basic.nack），并且requeue = false
基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能。
项目地址：https://github.com/YunaiV/ruoyi-vue-pro
环境准备配置
准备 MQ 的队列和环境：
正常交换机
正常队列（最长队列 5） ---- 正常消费者，拒绝消息
ttl 队列（过期时间 60 秒） ---- 没有消费者
死信交换机
死信队列
主要配置文件如下：
@Configuration
public class DeadConfig {
/* 正常配置 **********************************************************************************************************/
/**
* 正常交换机，开启持久化
*/
@Bean
DirectExchange normalExchange() {
return new DirectExchange("normalExchange", true, false);
}
@Bean
public Queue normalQueue() {
// durable: 是否持久化,默认是false,持久化队列：会被存储在磁盘上，当消息代理重启时仍然存在，暂存队列：当前连接有效
// exclusive: 默认也是false，只能被当前创建的连接使用，而且当连接关闭后队列即被删除。此参考优先级高于durable
// autoDelete: 是否自动删除，当没有生产者或者消费者使用此队列，该队列会自动删除。
Map args = deadQueueArgs();
// 队列设置最大长度
args.put("x-max-length", 5);
return new Queue("normalQueue", true, false, false, args);
}
@Bean
public Queue ttlQueue() {
Map args = deadQueueArgs();
// 队列设置消息过期时间 60 秒
args.put("x-message-ttl", 60 * 1000);
return new Queue("ttlQueue", true, false, false, args);
}
@Bean
Binding normalRouteBinding() {
return BindingBuilder.bind(normalQueue()).to(normalExchange()).with("normalRouting");
}
@Bean
Binding ttlRouteBinding() {
return BindingBuilder.bind(ttlQueue()).to(normalExchange()).with("ttlRouting");
}
/* 死信配置 **********************************************************************************************************/
/**
* 死信交换机
*/
@Bean
DirectExchange deadExchange() {
return new DirectExchange("deadExchange", true, false);
}
/**
* 死信队列
*/
@Bean
public Queue deadQueue() {
return new Queue("deadQueue", true, false, false);
}
@Bean
Binding deadRouteBinding() {
return BindingBuilder.bind(deadQueue()).to(deadExchange()).with("deadRouting");
}
/**
* 转发到 死信队列，配置参数
*/
private Map deadQueueArgs() {
Map map = new HashMap<>();
// 绑定该队列到私信交换机
map.put("x-dead-letter-exchange", "deadExchange");
map.put("x-dead-letter-routing-key", "deadRouting");
return map;
}
} arguments 具体参数如下：
| 参数名 | 作用 |
|---|---|
| x-message-ttl | 发送到队列的消息在丢弃之前可以存活多长时间（毫秒）。 |
| x-max-length | 队列最大长度 |
| x-expires | 队列在被自动删除（毫秒）之前可以使用多长时间。 |
| x-max-length | 队列在开始从头部删除之前可以包含多少就绪消息。 |
| x-max-length-bytes | 队列在开始从头部删除之前可以包含的就绪消息的总体大小。 |
| x-dead-letter-exchange | 设置队列溢出行为。这决定了在达到队列的最大长度时消息会发生什么。 有效值为drop-head或reject-publish。交换的可选名称，如果消息被拒绝或过期，将重新发布这些名称。 |
| x-dead-letter-routing-key | 可选的替换路由密钥，用于在消息以字母为单位时使用。如果未设置，将使用消息的原始路由密钥。 |
| x-max-priority | 队列支持的最大优先级数;如果未设置，队列将不支持消息优先级。 |
| x-queue-mode | 将队列设置为延迟模式，在磁盘上保留尽可能多的消息以减少内存使用;如果未设置，队列将保留内存缓存以尽快传递消息。 |
| x-queue-master-locator | 将队列设置为主位置模式，确定在节点集群上声明时队列主机所在的规则。 |
| x-overflow | 队列达到最大长度时，可选模式包括：drop-head, reject-publish 和 reject-publish-dlx. |
基于微服务的思想，构建在 B2C 电商场景下的项目实战。核心技术栈，是 Spring Boot + Dubbo 。未来，会重构成 Spring Cloud Alibaba 。
项目地址：https://github.com/YunaiV/onemall
队列达到最大长度
首先测试最简单的，没有消费者。
调用6次正常队列的生产方法。
/**
* 正常消息队列，队列最大长度5
*/
@GetMapping("/normalQueue")
public String normalQueue() {
Map map = new HashMap<>();
map.put("messageId", String.valueOf(UUID.randomUUID()));
map.put("data", System.currentTimeMillis() + ", 正常队列消息，最大长度 5");
rabbitTemplate.convertAndSend("normalExchange", "normalRouting", map, new CorrelationData());
return JSONObject.toJSONString(map);
} MQ 结果如下：
消息 TTL 过期
消息的TTL 指的是消息的存活时间，我们可以通过设置消息的TTL或者队列的TTL来实现。
消息的TTL ：对于设置了过期时间属性(expiration)的消息，消息如果在过期时间内没被消费，会过期
队列的TTL ：对于设置了过期时间属性(x-message-ttl)的队列，所有路由到这个队列的消息，都会设置上这个过期时间
两种配置都行，一般都用在定时任务，限时支付这种地方。
/**
* 消息 TTL, time to live
*/
@GetMapping("/ttlToDead")
public String ttlToDead() {
Map map = new HashMap<>();
map.put("messageId", String.valueOf(UUID.randomUUID()));
map.put("data", System.currentTimeMillis() + ", ttl队列消息");
rabbitTemplate.convertAndSend("normalExchange", "ttlRouting", map, new CorrelationData());
return JSONObject.toJSONString(map);
} 发送后：
等待过期后：
Demo 中只是为了方便，代码中尽量使用 消息TTL，不要用 队列TTL
拒绝消息
正常队列消费后拒绝消息，并且不进行重新入队：
@Component
@RabbitListener(queues = "normalQueue")
public class NormalConsumer {
@RabbitHandler
public void process(Map message, Channel channel, Message mqMsg) throws IOException {
System.out.println("收到消息，并拒绝重新入队 : " + message.toString());
channel.basicReject(mqMsg.getMessageProperties().getDeliveryTag(), false);
}
} MQ 控制台：
死信队列消费：
@Component
@RabbitListener(queues = "deadQueue")
public class DeadConsumer {
@RabbitHandler
public void process(Map message, Channel channel, Message mqMsg) throws IOException {
System.out.println("死信队列收到消息 : " + message.toString());
channel.basicAck(mqMsg.getMessageProperties().getDeliveryTag(), false);
}
} 消息顺序和实验一致：
死信队列收到消息 : {data=1631534291765, 正常队列消息，最大长度 5, messageId=bce3888b-da38-4299-ac88-d22cbe164739}
死信队列收到消息 : {data=1631535222745, ttl队列消息, messageId=a4617445-5aab-4fac-aec7-5709ea699598}
死信队列收到消息 : {data=1631534503765, 正常队列消息，最大长度 5, messageId=b65ecaab-5ce7-4597-a32c-c90b67ec46da}
死信队列收到消息 : {data=1631534511468, 正常队列消息，最大长度 5, messageId=d63d2a4c-e7d3-4f00-a6ca-78e2d62d1d92}
死信队列收到消息 : {data=1631534585087, 正常队列消息，最大长度 5, messageId=eed0c349-415b-43dc-aa79-c683122a1289}
死信队列收到消息 : {data=1631534588311, 正常队列消息，最大长度 5, messageId=7a7bd152-f2fa-4a74-b9e6-943ac7cbb3d4}
死信队列收到消息 : {data=1631534608504, 正常队列消息，最大长度 5, messageId=9de512a1-4ca4-4060-9096-27aba01c1687}欢迎加入我的知识星球，一起探讨架构，交流源码。加入方式，长按下方二维码噢：
已在知识星球更新源码解析如下：
最近更新《芋道 SpringBoot 2.X 入门》系列，已经 101 余篇，覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。
提供近 3W 行代码的 SpringBoot 示例，以及超 6W 行代码的电商微服务项目。
获取方式：点“在看”，关注公众号并回复 666 领取，更多内容陆续奉上。
文章有帮助的话，在看，转发吧。
谢谢支持哟 (*^__^*）