RabbitMQ 延迟消息实战

现实生活中有一些场景需要延迟或在特定时间发送消息，例如智能热水器需要 30 分钟后打开，未支付的订单或发送短信、电子邮件和推送通知下午 2:00 开始的促销活动。

RabbitMQ 本身没有直接支持延迟队列的功能，如果您搜索“如何在 RabbitMQ 中使用延迟消息”，您很可能会遇到两种可能的解决方案。第一种解决方案是使用消息 TTL 功能和死信功能的组合。第二种选择是使用官方的 RabbitMQ 延迟消息插件。

本文详细介绍了 RabbitMQ 延迟消息。

RabbitMQ 延迟消息实战
什么是 RabbitMQ？
- RabbitMQ 的主要特性
在 RabbitMQ 中启用延迟消息
- 使用 TTL 和 DLX 延迟消息传递
- RabbitMQ 延迟消息插件

RabbitMQ Assistant 是一款 RabbitMQ 可视化管理与监控——深入了解您的队列、订阅与消费消息，展示完整的消息流图以及压力测试。

什么是 RabbitMQ？

RabbitMQ 是一个开源消息代理（也称为面向消息的中间件），创建它是为了支持高级消息队列协议 (Advanced Message Queuing Protocol, AMQP)。此后，它通过插件架构进行了扩展，以支持简单（或流式）面向文本的消息协议 (Text Oriented Message Protocol, STOMP)、消息查询遥测传输 (Message Query Telemetry Transport, MQTT) 等协议。

对于集群和故障转移，RabbitMQ 服务器是用 Erlang 编写的，并采用了开放电信平台框架。用于与代理交互的客户端库可用于所有主要编程语言，源代码可在 Mozilla 公共许可证下获得。

简单来说，RabbitMQ是一个消息传递系统，可以在本地或云端使用。并且支持多种消息传递协议。

RabbitMQ 的主要特性

以下是 RabbitMQ 的一些特性：

集群：RabbitMQ 中的集群在设计时考虑了两个目标。如果一个节点发生故障，事件的消费者和生产者可以继续运行，同时添加其他节点以横向扩展消息传递吞吐量。
轻松路由：消息通过交换器然后到达队列，这提供了灵活的路由方式。对于更复杂的路由，用户可以将交换器连接在一起或将他们的交换器类型开发为插件。
可靠性：持久性、交付反馈、发布确认和高可用性是 RabbitMQ 对性能有直接影响的关键特性。
安全性：客户端证书检查和仅 SSL 通信可以帮助保护客户端连接。虚拟主机可以调节用户访问，确保高级消息隔离。

在 RabbitMQ 中启用延迟消息

很长一段时间以来，人们一直在寻找使用 RabbitMQ 实现延迟消息传递的方法。迄今为止，公认的解决方案是使用消息的组合——TTL 和死信交换器。

RabbitMQ 延迟消息插件向 RabbitMQ 添加了一种新的交换类型，如果用户愿意，允许延迟通过该交换路由的消息。让我们看看如何使用这两种方法。

使用 TTL 和 DLX 延迟消息传递
RabbitMQ 延迟消息插件

使用 TTL 和 DLX 延迟消息传递

通过组合这些功能，我们可以将消息发布到队列，该消息将在 TTL 后过期，然后它被重新被发送到另一个交换器中，这个交换器就是 DLX，绑定 DLX 的队列就称之为

死信队列。

下面创建一个队列，为其设置 TTL 和 DLX 等：

// 创建两个交换器，一个为正常的交换器exchange.normal，另一个为死信交换器exchange.dlx

channel.exchangeDeclare("exchange.dlx", "direct", true);

channel.exchangeDeclare("exchange.normal", "fanout", true);

//创建一个队列queue.normal，并绑定到exchange.normal

Map<String, Object> args = new HashMap <>();

//设置队列中消息的过期时间

args.put("x-message-ttl", 10000);

//当queue.normal中的消息过期时，将发送到exchange.dlx

args.put("x-dead-letter-exchange", "exchange.dlx");

//也可以为这个 DLX 指定路由键，如果没有特殊指定，则使用原队列的路由键

args.put("x-dead-letter-routing-key", "routingkey");

channel.queueDeclare("queue.normal", true, false, false, args);

channel.queueBind("queue.normal", "exchange.normal", "");

//创建死信队列queue.dlx，并当到死信交换器exchange.dlx

channel.queueDeclare("queue.dlx", true, false, false, null);

channel.queueBind("queue.dlx", "exchange.dlx", "routingkey");

//向exchange.normal发布一条消息

channel.basicPublish("exchange.normal", "rk", MessageProperties.PERSISTENT_TEXT_PLAIN , "dlx".getBytes());

参考下图，生产者首先发送一条携带路由键为“rk”的消息，然后经过交换器 exchange.normal 顺利地存储到队列queue.normal 中。由于队列 queue.normal 设置了过期时间为 10s，在这 10s 内没有消费者消费这条消息，那么判定这条消息为过期。由于设置了 DLX，过期之时，消息被丢给交换器 exchange.dlx 中，这时找到与 exchange.dlx 匹配的队列 queue.dlx，最后消息被存储在 queue.dlx 这个死信队列中。对于 RabbitMQ 来说，DLX 是一个非常有用的特性。它可以处理异常情况下，消息不能够被消费者正确消费（消费者调用了 Basic.Nack 或者 Basic.Reject）而被置入死信队列中的情况，后续分析程序可以通过消费这个死信队列中的内容来分析当时所遇到的异常情况，进而可以改善和优化系统。

在上图中，不仅展示的是死信队列的用法，也是延迟队列的用法，对于 queue.dlx 这个死信队列来说，同样可以看

作延迟队列。假设一个应用中需要将每条消息都设置为 10 秒的延迟，生产者通过 exchange.normal 这个交换器将发送的消息存储在 queue.normal 这个队列中。消费者订阅的并非是 queue.normal 这个队列，而是 queue.dlx 这个队列。当消息从 queue.normal 这个队列中过期之后被存入 queue.dlx 这个队列中，消费者就恰巧消费到了延迟 10 秒的这条消息。

在真实应用中，对于延迟队列可以根据延迟时间的长短分为多个等级，一般分为 5 秒、10 秒、30 秒、1 分钟、5 分

钟、10 分钟、30 分钟、1 小时这几个维度，当然也可以再细化一下。

参考下图，为了简化说明，这里只设置了 5 秒、10 秒、30 秒、1 分钟这四个等级。根据应用需求的不同，生产者在发送消息的时候通过设置不同的路由键，以此将消息发送到与交换器绑定的不同的队列中。这里队列分别设置了过期时间为 5 秒、10 秒、30 秒、1 分钟，同时也分别配置了 DLX 和相应的死信队列。当相应的消息过期时，就会转存到相应的死信队列（即延迟队列）中，这样消费者根据业务自身的情况，分别选择不同延迟等级的延迟队列进行消费。

RabbitMQ 延迟消息插件

从安装插件开始，但首先，让我们看一下以下先决条件：

RabbitMQ 版本 3.5.8 及更高版本。
Erlang/OTP 18.0 及更高版本

插件安装

在Github下载插件。将插件复制到 RabbitMQ 的插件文件夹，然后运行以下命令启用它：

# 下载插件

wget https://github.com/rabbitmq/rabbitmq-delayed-message-exchange/releases/download/3.11.1/rabbitmq_delayed_message_exchange-3.11.1.ez

# 将插件移动到plugins目录下

mv rabbitmq_delayed_message_exchange-3.11.1.ez ./rabbitmq_server-3.11.1/plugins/

# 启用插件

rabbitmq-plugins enable rabbitmq_delayed_message_exchange

延迟消息交换器

要使用延迟消息交换器，只需声明一个类型为 x-delayed-message 的交换器，如下所示：

// ... elided code ...

Map<String, Object> args = new HashMap<String, Object>();

args.put("x-delayed-type", "direct");

channel.exchangeDeclare("my-exchange", "x-delayed-message", true, false, args);

// ... more code ...

稍后，我们将解释交换声明中的特殊参数 x-delayed-type 的含义。

延迟消息

要延迟消息，用户必须使用 x-delay 标头发布它，该标头接受一个整数，表示消息应由 RabbitMQ 延迟的毫秒数。值得注意的是，在此上下文中的延迟表示着消息路由到队列或其他交换器的延迟。交换器没有消费者的概念。

因此，一旦延迟过去，插件将尝试将消息路由到与交换器的路由规则匹配的队列。如果消息无法路由到任何队列，它将被丢弃。

// ... elided code ...

byte[] messageBodyBytes = "delayed payload".getBytes();

AMQP.BasicProperties.Builder props = new AMQP.BasicProperties.Builder();

headers = new HashMap<String, Object>();

headers.put("x-delay", 5000);

props.headers(headers);

channel.basicPublish("my-exchange", "", props.build(), messageBodyBytes);

在上面的示例中，消息在被插件路由之前将延迟五秒钟。

路由灵活性

当我们在上面声明交换时，我们使用了一个设置为 direct 的 x-delayed-type 参数。这告诉交换器我们希望它在路由消息、创建绑定等时具有什么样的行为。

检查延迟消息

一旦我们在消费者端收到消息，我们如何判断消息是否被延迟？ x-delay 消息头由插件保留。如果您以 5000 毫秒的延迟发送消息，消费者会发现 x-delay 标头设置为 5000。

参考资料：