当前位置:   article > 正文

RabbitMQ从0到1完整学习笔记二:《高级篇》

RabbitMQ从0到1完整学习笔记二:《高级篇》

目录

1. 发送者的可靠性

1.1.生产者连接重试机制

1.2.生产者确认机制(发布确认)

1.3.实现生产者确认

1.3.1.开启生产者确认

1.3.2.定义ReturnCallback

1.3.3.定义ConfirmCallback

拓展: confirm 模式细节处理

2.MQ的可靠性

2.1.数据持久化

2.1.1.交换机持久化

2.1.2.队列持久化

2.1.3.消息持久化

2.2.LazyQueue

2.2.1.控制台配置Lazy模式

2.2.2.代码配置Lazy模式

2.2.3.更新已有队列为lazy模式

拓展:惰性队列vs持久化队列 

拓展:队列的销毁注意细节 

3.消费者的可靠性

3.1.消费者确认机制

拓展:消息应答策略的选择讨论

3.2.失败重试机制

3.3.失败处理策略

3.4.业务幂等性

3.4.1.唯一消息ID

3.4.2.业务判断

3.5.兜底方案

拓展:应答和发布区别

拓展:备份交换机 

什么是备份交换机呢?

原理步骤

4. 延迟消息

4.1.死信交换机和延迟消息

4.1.1死信交换机

4.1.2.延迟消息

4.1.3.总结

4.2.DelayExchange插件

4.2.1.下载

4.2.3.声明延迟交换机

4.2.4.发送延迟消息

拓展:优先级队列 

使用场景

实现步骤

4.5.订单状态同步问题

4.5.1.定义常量

4.5.2.抽取共享mq配置

4.5.3.改造下单业务

​​​​4.5.4.编写查询支付状态接口

4.5.5.消息监听


在昨天的练习作业中,我们改造了余额支付功能,在支付成功后利用RabbitMQ通知交易服务,更新业务订单状态为已支付。 但是大家思考一下,如果这里MQ通知失败,支付服务中支付流水显示支付成功,而交易服务中的订单状态却显示未支付,数据出现了不一致。 此时前端发送请求查询支付状态时,肯定是查询交易服务状态,会发现业务订单未支付,而用户自己知道已经支付成功,这就导致用户体验不一致。

因此,这里我们必须尽可能确保MQ消息的可靠性,即:消息应该至少被消费者处理1次 那么问题来了:

  • 我们该如何确保MQ消息的可靠性

  • 如果真的发送失败,有没有其它的兜底方案?

这些问题,在今天的学习中都会找到答案。

1. 发送者的可靠性

首先,我们一起分析一下消息丢失的可能性有哪些。 消息从发送者发送消息,到消费者处理消息,需要经过的流程是这样的:

消息从生产者到消费者的每一步都可能导致消息丢失:

  • 发送消息时丢失:

    • 生产者发送消息时连接MQ失败

    • 生产者发送消息到达MQ后未找到Exchange

    • 生产者发送消息到达MQ的Exchange后,未找到合适的Queue

    • 消息到达MQ后,处理消息的进程发生异常

  • MQ导致消息丢失:

    • 消息到达MQ,保存到队列后,尚未消费就突然宕机

  • 消费者处理消息时:

    • 消息接收后尚未处理突然宕机

    • 消息接收后处理过程中抛出异常

综上,我们要解决消息丢失问题,保证MQ的可靠性,就必须从3个方面入手:

  • 确保生产者一定把消息发送到MQ

  • 确保MQ不会将消息弄丢

  • 确保消费者一定要处理消息


 这一章我们先来看如何确保生产者一定能把消息发送到MQ

1.1.生产者连接重试机制

首先第一种情况,就是生产者发送消息时,出现了网络故障,导致与MQ的连接中断。

为了解决这个问题,SpringAMQP提供的消息发送时的重试机制。即:

RabbitTemplate与MQ连接超时后,多次重试

修改publisher模块的application.yaml文件,添加下面的内容:

  1. spring:
  2. rabbitmq:
  3. connection-timeout: 1s # 设置MQ的连接超时时间
  4. template:
  5. retry:
  6. enabled: true # 开启超时重试机制
  7. initial-interval: 1000ms # 失败后的初始等待时间
  8. multiplier: 1 # 失败后下次的等待时长倍数,下次等待时长 = initial-interval * multiplier
  9. max-attempts: 3 # 最大重试次数

我们利用命令停掉RabbitMQ服务:

docker stop mq

然后测试发送一条消息,会发现会每隔1秒重试1次,总共重试了3次。消息发送的超时重试机制配置成功了!

注意:当网络不稳定的时候,利用重试机制可以有效提高消息发送的成功率。不过SpringAMQP提供的重试机制是阻塞式的重试,也就是说多次重试等待的过程中,当前线程是被阻塞的。 如果对于业务性能有要求,建议禁用重试机制。如果一定要使用,请合理配置等待时长和重试次数,当然也可以考虑使用异步线程来执行发送消息的代码。 


1.2.生产者确认机制(发布确认)

一般情况下,只要生产者与MQ之间的网路连接顺畅,基本不会出现发送消息丢失的情况,因此大多数情况下我们无需考虑这种问题。 不过,在少数情况下,也会出现消息发送到MQ之后丢失的现象,比如:

  • MQ内部处理消息的进程发生了异常

  • 生产者发送消息到达MQ后未找到Exchange

  • 生产者发送消息到达MQ的Exchange后,未找到合适的Queue,因此无法路由

针对上述情况,RabbitMQ提供了生产者消息确认机制,包括Publisher ConfirmPublisher Return两种。在开启确认机制的情况下,当生产者发送消息给MQ后,MQ会根据消息处理的情况返回不同的回执。 具体如图所示:

image.png

总结如下:

  • 当消息投递到MQ,但是路由失败时,通过Publisher Return返回异常信息,同时返回ack的确认信息,代表投递成功(失败了还会返回ack是因为确认机制只能保证该消息是否到达MQ,不管他是否被消费)

  • 临时消息投递到了MQ,并且入队成功,返回ACK,告知投递成功

  • 持久消息投递到了MQ,并且入队完成持久化,返回ACK ,告知投递成功

  • 其它情况都会返回NACK,告知投递失败

其中acknack属于Publisher Confirm机制,ack是投递成功;nack是投递失败。而return则属于Publisher Return机制。 默认两种机制都是关闭状态,需要通过配置文件来开启。

        RabbitMQ的发布确认机制只能确保消息已经成功发布到消息队列,但无法直接知道消息是否被消费。发布确认机制只告知发布者消息是否成功到达消息队列,而不涉及消息被消费的情况。

        如果需要知道消息是否被消费,可结合RabbitMQ的消费者确认机制(Consumer Acknowledgements)。在消费者从消息队列中接收到消息后,可以发送个确认消息给RabbitMQ来表示该消息已被成功消费。这种方式可以通过设置自动确认或手动确认来实现。


1.3.实现生产者确认

1.3.1.开启生产者确认

在publisher模块的application.yaml中添加配置:

  1. spring:
  2. rabbitmq:
  3. publisher-confirm-type: correlated # 开启publisher confirm机制,并设置confirm类型
  4. publisher-returns: true # 开启publisher return机制

这里publisher-confirm-type有三种模式可选:

  • none:关闭confirm机制

  • simple:同步阻塞等待MQ的回执

  • correlated:MQ异步回调返回回执

一般我们推荐使用correlated,异步回调机制。

1.3.2.定义ReturnCallback

每个RabbitTemplate只能配置一个ReturnCallback,因此我们可以在配置类中统一设置。我们在publisher模块定义一个配置类:

image.png

内容如下:

  1. @Slf4j
  2. @AllArgsConstructor
  3. @Configuration
  4. public class MqConfig {
  5. private final RabbitTemplate rabbitTemplate;
  6. @PostConstruct
  7. public void init(){
  8. rabbitTemplate.setReturnsCallback(new RabbitTemplate.ReturnsCallback() {
  9. @Override
  10. public void returnedMessage(ReturnedMessage returned) {
  11. log.error("触发return callback,");
  12. log.debug("exchange: {}", returned.getExchange());
  13. log.debug("routingKey: {}", returned.getRoutingKey());
  14. log.debug("message: {}", returned.getMessage());
  15. log.debug("replyCode: {}", returned.getReplyCode());
  16. log.debug("replyText: {}", returned.getReplyText());
  17. }
  18. });
  19. }
  20. }
  1. public void sendMessage(String exchange, String routingKey, Object message) {
  2. rabbitTemplate.send(exchange, routingKey, (Message) message);
  3. // 在发送消息的时候,如果消息没有被正确路由到指定的队列,将执行ReturnCallback的回调函数
  4. }

@PostConstruct是Java EE或Spring框架中的一个注解,用于指定一个方法在对象实例化后立即执行。通常在使用IoC(控制反转)容器时,我们可以通过@PostConstruct注解来标记一个方法,在对象创建完成后执行一些初始化逻辑。


1.3.3.定义ConfirmCallback

由于每个消息发送时的处理逻辑不一定相同,因此ConfirmCallback需要在每次发消息时定义。具体来说,是在调用RabbitTemplate中的convertAndSend方法时,多传递一个参数:

image.png

这里的CorrelationData中包含两个核心的东西:

  • id:消息的唯一标示,MQ对不同的消息的回执以此做判断,避免混淆

  • SettableListenableFuture:回执结果的Future对象

将来MQ的回执就会通过这个Future来返回,我们可以提前给CorrelationData中的Future添加回调函数来处理消息回执:

image.png

我们新建一个测试,向系统自带的交换机发送消息,并且添加ConfirmCallback

  1. @Test
  2. void testPublisherConfirm() {
  3. // 1.创建CorrelationData
  4. CorrelationData cd = new CorrelationData();
  5. // 2.给Future添加ConfirmCallback
  6. cd.getFuture().addCallback(new ListenableFutureCallback<CorrelationData.Confirm>() {
  7. @Override
  8. public void onFailure(Throwable ex) {
  9. // 2.1.Future发生异常时的处理逻辑,基本不会触发
  10. log.error("send message fail", ex);
  11. }
  12. @Override
  13. public void onSuccess(CorrelationData.Confirm result) {
  14. // 2.2.Future接收到回执的处理逻辑,参数中的result就是回执内容
  15. if(result.isAck()){ // result.isAck(),boolean类型,true代表ack回执,false 代表 nack回执
  16. log.debug("发送消息成功,收到 ack!");
  17. }else{ // result.getReason(),String类型,返回nack时的异常描述
  18. log.error("发送消息失败,收到 nack, reason : {}", result.getReason());
  19. }
  20. }
  21. });
  22. // 3.发送消息
  23. rabbitTemplate.convertAndSend("hmall.direct", "q", "hello", cd);
  24. }

执行结果如下:

image.png

可以看到,由于传递的RoutingKey是错误的,路由失败后,触发了return callback,同时也收到了ack。 当我们修改为正确的RoutingKey以后,就不会触发return callback了,只收到ack。 而如果连交换机都是错误的,则只会收到nack。

注意开启生产者确认比较消耗MQ性能,一般不建议开启。而且大家思考一下触发确认的几种情况:

  • 路由失败:一般是因为RoutingKey错误导致,往往是编程导致

  • 交换机名称错误:同样是编程错误导致

  • MQ内部故障:这种需要处理,但概率往往较低。因此只有对消息可靠性要求非常高的业务才需要开启,而且仅仅需要开启ConfirmCallback处理nack就可以了。


拓展: confirm 模式细节处理

        confirm 模式最大的好处在于是异步的,一旦发布一条消息,生产者应用程序就可以在等信道返回确认的同时继续发送下一条消息,当消息最终得到确认之后,生产者应用便可以通过回调方法来处理该确认消息,如果RabbitMQ 因为自身内部错误导致消息丢失,就会发送一条 nack 消息, 生产者应用程序同样可以在回调方法中处理该 nack 消息。

细节:

监听器要定义在发布消息的步骤前面,不然在发消息的过程中就无法捕捉发布确认结果,所以说要将其提前打开监听器再发布消息

deliveryTag(一条消息的标记号)的初始值也是0L,但是标记发送的消息是从1开始的,1-65535,这样getNextPublishSeqNo()(下一条消息的标记号)的值和deliveryTag的值就是对应的


2.MQ的可靠性

消息到达MQ以后,如果MQ不能及时保存,也会导致消息丢失,所以MQ的可靠性也非常重要。

2.1.数据持久化

为了提升性能,默认情况下MQ的数据都是在内存存储的临时数据,重启后就会消失。为了保证数据的可靠性,必须配置数据持久化,包括:

  • 交换机持久化

  • 队列持久化

  • 消息持久化

我们以控制台界面为例来说明。

2.1.1.交换机持久化

在控制台的Exchanges页面,添加交换机时可以配置交换机的Durability参数:

image.png

设置为Durable就是持久化模式,Transient就是临时模式。

2.1.2.队列持久化

在控制台的Queues页面,添加队列时,同样可以配置队列的Durability参数:

image.png

除了持久化以外,你可以看到队列还有很多其它参数,有一些我们会在后期学习。

RabbitMQ的非持久队列确实是应该在生产者和消费者断开连接后就被销毁的,但是如果队列里还存在未被消费的消息,那么队列就不会被自动删除,直到所有的消息都被消费或备份。另外,如果设置了auto_delete参数为false,也会导致队列不会自动删除。建议使用命令行或者管理界面查看队列状态,以确认队列是否已被删除。

2.1.3.消息持久化

在控制台发送消息的时候,可以添加很多参数,而消息的持久化是要配置一个properties

image.png

说明:在开启持久化机制以后,如果同时还开启了生产者确认,那么MQ会在消息持久化以后才发送ACK回执,进一步确保消息的可靠性。 不过出于性能考虑,为了减少IO次数,发送到MQ的消息并不是逐条持久化到数据库的,而是每隔一段时间批量持久化。一般间隔在100毫秒左右,这就会导致ACK有一定的延迟,因此建议生产者确认全部采用异步方式

持久化消息会同时写入磁盘内存(加快读取速度),非持久化消息会暂存在内存中,只有当内存不够用时,才将消息写入磁盘(但一般重启之后,在磁盘中的非持久化消息就没有了)。

消息持久化这个方法并不能保证消息100%不丢失,如果在当消息刚准备存储在磁盘的时候 但是还没有存储完,消息还在缓存的一个间隔点。此时并没有真正写入磁盘。如果一旦服务崩溃宕机,消息还是会丢失。


2.2.LazyQueue

在默认情况下,RabbitMQ会将接收到的信息保存在内存中以降低消息收发的延迟。但在某些特殊情况下,这会导致消息积压,比如:

  • 消费者宕机或出现网络故障

  • 消息发送量激增,超过了消费者处理速度

  • 消费者处理业务发生阻塞

一旦出现消息堆积问题,RabbitMQ的内存占用就会越来越高,直到触发内存预警上限。此时RabbitMQ会将内存消息刷到磁盘上,这个行为成为PageOut. PageOut会耗费一段时间,并且会阻塞队列进程。因此在这个过程中RabbitMQ不会再处理新的消息,生产者的所有请求都会被阻塞。

为了解决这个问题,从RabbitMQ的3.6.0版本开始,就增加了Lazy Queues的模式,也就是惰性队列。惰性队列的特征如下:

  • 接收到消息后直接存入磁盘而非内存

  • 消费者要消费消息时才会从磁盘中读取并加载到内存(也就是懒加载)

  • 支持数百万条的消息存储

而在3.12版本之后,LazyQueue已经成为所有队列的默认格式。因此官方推荐升级MQ为3.12版本或者所有队列都设置为LazyQueue模式。

2.2.1.控制台配置Lazy模式

在添加队列的时候,添加x-queue-mod=lazy参数即可设置队列为Lazy模式:

image.png

2.2.2.代码配置Lazy模式

在利用SpringAMQP声明队列的时候,添加x-queue-mod=lazy参数也可设置队列为Lazy模式:

  1. @Bean
  2. public Queue lazyQueue(){
  3. return QueueBuilder
  4. .durable("lazy.queue")
  5. .lazy() // 开启Lazy模式
  6. .build();
  7. }

这里是通过QueueBuilderlazy()函数配置Lazy模式,底层源码如下:

image.png

当然,我们也可以基于注解来声明队列并设置为Lazy模式:

  1. @RabbitListener(queuesToDeclare = @Queue(
  2. name = "lazy.queue",
  3. durable = "true",
  4. arguments = @Argument(name = "x-queue-mode", value = "lazy")
  5. ))
  6. public void listenLazyQueue(String msg){
  7. log.info("接收到 lazy.queue的消息:{}", msg);
  8. }

2.2.3.更新已有队列为lazy模式

对于已经存在的队列,也可以配置为lazy模式,但是要通过设置policy实现。 可以基于命令行设置policy:

rabbitmqctl set_policy Lazy "^lazy-queue$" '{"queue-mode":"lazy"}' --apply-to queues  

命令解读:

  • rabbitmqctl :RabbitMQ的命令行工具

  • set_policy :添加一个策略

  • Lazy :策略名称,可以自定义

  • "^lazy-queue$" :用正则表达式匹配队列的名字

  • '{"queue-mode":"lazy"}' :设置队列模式为lazy模式

  • --apply-to queues:策略的作用对象,是所有的队列

当然,也可以在控制台配置policy,进入在控制台的Admin页面,点击Policies,即可添加配置:

image.png


拓展:惰性队列vs持久化队列 

        RabbitMQ的惰性队列是指在队列中添加消息时会将其暂存到磁盘上,而不是保存在内存中。相反,持久化队列是指消息可以被保存在队列中并在RabbitMQ服务重启时保留

        惰性队列的主要优点在于它可以避免内存溢出和性能问题当许多消息被添加到队列中时,若使用持久化队列,会占用大量的内存。但使用惰性队列时,消息在必要时被加载到 RAM 中,因而保证了高效的内存利用率。惰性队列适用于需要处理大量消息的极端情况,并且长时间运行,数据量增加的情况下,更适合使用。

        持久化队列主要适用于需要确保即使在RabbitMQ宕机或重启的情况下仍能找回的消息。持久化队列将队列中的消息保存到磁盘上,因此可以确保消息不会丢失。持久化队列适用于数据量小,特别是小型应用场景下使用

总之,对于性能要求高的大型应用程序,可以考虑使用惰性队列;而对于小型应用程序,特别是需要保证消息的完整性和不可丢失性的应用程序,持久化队列更加适用。


拓展:队列的销毁注意细节 

1. 当队列被显式地删除时,队列将被销毁。

2. 当最后一个绑定队列的消费者关闭其通道/连接时,队列将被删除。 如果显式地将queue.unused-queue-ttl参数设置为非零值,则队列可能会在未使用一段时间后被自动删除。

3. 当RabbitMQ服务器重启时,非持久队列会被自动删除。

4. 如果将x-expires参数设置为非零值,则队列可能在未使用一段时间后被自动删除。

5. 如果队列被指定为具有自动删除属性,则队列将在完全消耗或关闭时自动删除。

请注意,如果队列中未设置消息/元素计数,则即使队列未在消费者中使用过,也不会被自动删除。

RabbitMQ的非持久化队列在生产者和消费者断开连接后会被销毁。这是因为非持久化队列的生存期仅限于存在连接的时候。一旦所有消费者和生产者都断开连接,队列就会被删除。如果您需要在RabbitMQ断开连接后仍要使用队列,请创建一个持久化队列。持久化队列会将队列的元数据和消息保存在磁盘上,即使RabbitMQ重启或断电,也能保证数据不会丢失


3.消费者的可靠性

当RabbitMQ向消费者投递消息以后,需要知道消费者的处理状态如何。因为消息投递给消费者并不代表就一定被正确消费了,可能出现的故障有很多,比如:

  • 消息投递的过程中出现了网络故障

  • 消费者接收到消息后突然宕机

  • 消费者接收到消息后,因处理不当导致异常

  • ...

一旦发生上述情况,消息也会丢失。因此,RabbitMQ必须知道消费者的处理状态,一旦消息处理失败才能重新投递消息。 但问题来了:RabbitMQ如何得知消费者的处理状态呢?


3.1.消费者确认机制

为了确认消费者是否成功处理消息,RabbitMQ提供了消费者确认机制Consumer Acknowledgement)。即:当消费者处理消息结束后,应该向RabbitMQ发送一个回执,告知RabbitMQ自己消息处理状态。回执有三种可选值:

  • ack:成功处理消息,RabbitMQ从队列中删除该消息

  • nack:消息处理失败,RabbitMQ需要再次投递消息

  • reject:消息处理失败并拒绝该消息,RabbitMQ从队列中删除该消息

一般reject方式用的较少,除非是消息格式有问题,那就是开发问题了。因此大多数情况下我们需要将消息处理的代码通过try catch机制捕获,消息处理成功时返回ack,处理失败时返回nack.

由于消息回执的处理代码比较统一,因此SpringAMQP帮我们实现了消息确认。并允许我们通过配置文件设置ACK处理方式,有三种模式:

  • none不处理。即消息投递给消费者后立刻ack,消息会立刻从MQ删除。非常不安全,不建议使用

  • manual手动模式。需要自己在业务代码中调用api,发送ackreject,存在业务入侵,但更灵活

  • auto自动模式。SpringAMQP利用AOP对我们的消息处理逻辑做了环绕增强,当业务正常执行时则自动返回ack. 当业务出现异常时,根据异常判断返回不同结果:

    • 如果是业务异常,会自动返回nack

    • 如果是消息处理或校验异常,自动返回reject;

通过下面的配置可以修改SpringAMQP的ACK处理方式:

  1. spring:
  2. rabbitmq:
  3. listener:
  4. simple:
  5. acknowledge-mode: none # 不做处理

修改consumer服务的SpringRabbitListener类中的方法,模拟一个消息处理的异常:

  1. @RabbitListener(queues = "simple.queue")
  2. public void listenSimpleQueueMessage(String msg) throws InterruptedException {
  3.    log.info("spring 消费者接收到消息:【" + msg + "】");
  4.    if (true) {
  5.        throw new MessageConversionException("故意的");
  6.   }
  7.    log.info("消息处理完成");
  8. }

测试可以发现:当消息处理发生异常时,消息依然被RabbitMQ删除了。

我们再次把确认机制修改为auto:

  1. spring:
  2. rabbitmq:
  3.   listener:
  4.     simple:
  5.       acknowledge-mode: auto # 自动ack

在异常位置打断点,再次发送消息,程序卡在断点时,可以发现此时消息状态为unacked(未确定状态):

image.png

放行以后,由于抛出的是消息转换异常,因此Spring会自动返回reject,所以消息依然会被删除:

image.png

我们将异常改为RuntimeException类型:

  1. @RabbitListener(queues = "simple.queue")
  2. public void listenSimpleQueueMessage(String msg) throws InterruptedException {
  3. log.info("spring 消费者接收到消息:【" + msg + "】");
  4. if (true) {
  5. throw new RuntimeException("故意的");
  6. }
  7. log.info("消息处理完成");
  8. }

在异常位置打断点,然后再次发送消息测试,程序卡在断点时,可以发现此时消息状态为unacked(未确定状态):

image.png

放行以后,由于抛出的是业务异常,所以Spring返回ack,最终消息恢复至Ready状态,并且没有被RabbitMQ删除:

image.png

当我们把配置改为auto时,消息处理失败后,会回到RabbitMQ,并重新投递到消费者。


拓展:消息应答策略的选择讨论

自动应答(手动应答的好处是可以批量应答并且减少网络拥堵)

        消息发送后立即被认为已经传送成功,这种模式需要在高吞吐量和数据传输安全性方面做权衡,因为这种模式如果消息在接收到之前,消费者那边出现连接或者 channel 关闭,那么消息就丢失了,当然另一方面这种模式消费者那边可以传递过载的消息,没有对传递的消息数量进行限制,当然这样有可能使得消费者这边由于接收太多还来不及处理的消息,导致这些消息的积压,最终使得内存耗尽,最终这些消费者线程被操作系统杀死,所以这种模式仅适用在消费者可以高效并以 某种速率能够处理这些消息的情况下使用。(自动应答没有什么批量的概念,因为接收到就立马应答了,哪里会等到后边再一起应答)

        设置了自动应答后,消费者在接收到消息后就会立马自动应答,然后rabbitMQ就会立马将该消息从队列中删除,但是这是不安全的,要知道,我们接收消息的目的还是使用消息,如果说在接收到消息后在时候消息的时候,由于报错等一系列因素导致的数据丢失了,那么我们就没有后悔的余地了,因为队列中的消息已经被删除。所以说,我们最好采用手动应答的方式,在接收到消息,并处理了消息的流程的最后再进行手动应答,进行消息在队列中删除的过程,这样子哪怕在处理消息的过程中丢失了消息都能在队列中再拿一份出来


3.2.失败重试机制

        当消费者出现异常后,消息会不断requeue(重入队)到队列,再重新发送给消费者。如果消费者再次执行依然出错,消息会再次requeue到队列,再次投递,直到消息处理成功为止。 极端情况就是消费者一直无法执行成功,那么消息requeue就会无限循环,导致mq的消息处理飙升,带来不必要的压力:

        当然,上述极端情况发生的概率还是非常低的,不过不怕一万就怕万一。为了应对上述情况Spring又提供了消费者失败重试机制

在消费者出现异常时利用本地重试,而不是无限制的requeue到mq队列。

修改consumer服务的application.yml文件,添加内容:

  1. spring:
  2. rabbitmq:
  3. listener:
  4. simple:
  5. retry:
  6. enabled: true # 开启消费者失败重试
  7. initial-interval: 1000ms # 初识的失败等待时长为1秒
  8. multiplier: 1 # 失败的等待时长倍数,下次等待时长 = multiplier * last-interval
  9. max-attempts: 3 # 最大重试次数
  10. stateless: true # true无状态;false有状态。如果业务中包含事务,这里改为false

stateless 配置是 RabbitMQ 中一个重要的属性,用于定义消息的传递方式。当将队列和交换机配置为无状态时,它们不会在磁盘上持久化消息。这意味着,如果 RabbitMQ 服务被重启或崩溃,所有未处理的消息都会丢失。Stateless 配置适用于那些对消息持久性要求不高、可丢失的场景,例如临时数据的传递或不需要保留的日志信息等。stateless 为false便是不加持久化,这也是为什么说如果包含了事务就不需要考虑用持久化来确保数据的完整性

重启consumer服务,重复之前的测试。可以发现:

  • 消费者在失败后消息没有重新回到MQ无限重新投递,而是在本地重试了3次

  • 本地重试3次以后,抛出了AmqpRejectAndDontRequeueException异常。查看RabbitMQ控制台,发现消息被删除了,说明最后SpringAMQP返回的是reject

结论:

  • 开启本地重试时,消息处理过程中抛出异常,不会requeue到队列,而是在消费者本地重试

  • 重试达到最大次数后,Spring会返回reject,消息会被丢弃 


3.3.失败处理策略

在之前的测试中,本地测试达到最大重试次数后,消息会被丢弃。这在某些对于消息可靠性要求较高的业务场景下,显然不太合适了。 因此Spring允许我们自定义重试次数耗尽后的消息处理策略,这个策略是由MessageRecovery接口来定义的,它有3个不同实现:(策略模式)

  • RejectAndDontRequeueRecoverer:重试耗尽后,直接reject,丢弃消息。默认就是这种方式

  • ImmediateRequeueMessageRecoverer:重试耗尽后,返回nack,消息重新入队

  • RepublishMessageRecoverer:重试耗尽后,将失败消息投递到指定的交换机

比较优雅的一种处理方案是RepublishMessageRecoverer,失败后将消息投递到一个指定的,专门存放异常消息的队列,后续由人工集中处理。

1)在consumer服务中定义处理失败消息的交换机和队列

  1. @Bean
  2. public DirectExchange errorMessageExchange(){
  3. return new DirectExchange("error.direct");
  4. }
  5. @Bean
  6. public Queue errorQueue(){
  7. return new Queue("error.queue", true);
  8. }
  9. @Bean
  10. public Binding errorBinding(Queue errorQueue, DirectExchange errorMessageExchange){
  11. return BindingBuilder.bind(errorQueue).to(errorMessageExchange).with("error");
  12. }

 2)定义一个RepublishMessageRecoverer,关联队列和交换机

  1. @Bean
  2. public MessageRecoverer republishMessageRecoverer(RabbitTemplate rabbitTemplate){
  3. return new RepublishMessageRecoverer(rabbitTemplate, "error.direct", "error");
  4. }

完整代码如下:

  1. @Configuration
  2. @ConditionalOnProperty(name = "spring.rabbitmq.listener.simple.retry.enabled", havingValue = "true")
  3. public class ErrorMessageConfig {
  4. @Bean
  5. public DirectExchange errorMessageExchange(){
  6. return new DirectExchange("error.direct");
  7. }
  8. @Bean
  9. public Queue errorQueue(){
  10. return new Queue("error.queue", true);
  11. }
  12. @Bean
  13. public Binding errorBinding(Queue errorQueue, DirectExchange errorMessageExchange){
  14. return BindingBuilder.bind(errorQueue).to(errorMessageExchange).with("error");
  15. }
  16. @Bean
  17. public MessageRecoverer republishMessageRecoverer(RabbitTemplate rabbitTemplate){
  18. return new RepublishMessageRecoverer(rabbitTemplate, "error.direct", "error");
  19. }
  20. }

3.4.业务幂等性

何为幂等性? 幂等是一个数学概念,用函数表达式来描述是这样的:f(x) = f(f(x)),例如求绝对值函数。 在程序开发中,则是指同一个业务,执行一次或多次对业务状态的影响是一致的。例如:

  • 根据id删除数据

  • 查询数据

  • 新增数据

但数据的更新往往不是幂等的,如果重复执行可能造成不一样的后果。比如:

  • 取消订单,恢复库存的业务。如果多次恢复就会出现库存重复增加的情况

  • 退款业务。重复退款对商家而言会有经济损失。

所以,我们要尽可能避免业务被重复执行。 然而在实际业务场景中,由于意外经常会出现业务被重复执行的情况,例如:

  • 页面卡顿时频繁刷新导致表单重复提交

  • 服务间调用的重试

  • MQ消息的重复投递

我们在用户支付成功后会发送MQ消息到交易服务,修改订单状态为已支付,就可能出现消息重复投递的情况。如果消费者不做判断,很有可能导致消息被消费多次,出现业务故障。 举例:

  1. 假如用户刚刚支付完成,并且投递消息到交易服务,交易服务更改订单为已支付状态。

  2. 由于某种原因,例如网络故障导致生产者没有得到确认,隔了一段时间后重新投递给交易服务。

  3. 但是,在新投递的消息被消费之前,用户选择了退款,将订单状态改为了已退款状态。

  4. 退款完成后,新投递的消息才被消费,那么订单状态会被再次改为已支付。业务异常。

因此,我们必须想办法保证消息处理的幂等性。这里给出两种方案:

  • 唯一消息ID

  • 业务状态判断


3.4.1.唯一消息ID

这个思路非常简单:

  1. 每一条消息都生成一个唯一的id,与消息一起投递给消费者。

  2. 消费者接收到消息后处理自己的业务,业务处理成功后将消息ID保存到数据库

  3. 如果下次又收到相同消息,去数据库查询判断是否存在,存在则为重复消息放弃处理。

我们该如何给消息添加唯一ID呢? 其实很简单,SpringAMQP的MessageConverter自带了MessageID的功能,我们只要开启这个功能即可。

以Jackson的消息转换器为例:

  1. @Bean
  2. public MessageConverter messageConverter(){
  3. // 1.定义消息转换器
  4. Jackson2JsonMessageConverter jjmc = new Jackson2JsonMessageConverter();
  5. // 2.配置自动创建消息id,用于识别不同消息,也可以在业务中基于ID判断是否是重复消息
  6. jjmc.setCreateMessageIds(true);
  7. return jjmc;
  8. }

3.4.2.业务判断

业务判断就是基于业务本身的逻辑或状态来判断是否是重复的请求或消息,不同的业务场景判断的思路也不一样。 例如我们当前案例中,处理消息的业务逻辑是把订单状态从未支付修改为已支付。因此我们就可以在执行业务时判断订单状态是否是未支付,如果不是则证明订单已经被处理过,无需重复处理。

相比较而言,消息ID的方案需要改造原有的数据库,所以我更推荐使用业务判断的方案。

以支付修改订单的业务为例,我们需要修改OrderServiceImpl中的markOrderPaySuccess方法:

  1.  @Override
  2.    public void markOrderPaySuccess(Long orderId) {
  3.        // 1.查询订单
  4.        Order old = getById(orderId);
  5.        // 2.判断订单状态
  6.        if (old == null || old.getStatus() != 1) {
  7.            // 订单不存在或者订单状态不是1,放弃处理
  8.            return;
  9.       }
  10.        // 3.尝试更新订单
  11.        Order order = new Order();
  12.        order.setId(orderId);
  13.        order.setStatus(2);
  14.        order.setPayTime(LocalDateTime.now());
  15.        updateById(order);
  16.   }

上述代码逻辑上符合了幂等判断的需求,但是由于判断和更新是两步动作,因此在极小概率下可能存在线程安全问题。

我们可以合并上述操作为这样:

  1. @Override
  2. public void markOrderPaySuccess(Long orderId) {
  3.    // UPDATE `order` SET status = ? , pay_time = ? WHERE id = ? AND status = 1
  4.    lambdaUpdate()
  5.           .set(Order::getStatus, 2)
  6.           .set(Order::getPayTime, LocalDateTime.now())
  7.           .eq(Order::getId, orderId)
  8.           .eq(Order::getStatus, 1)
  9.           .update();
  10. }

注意看,上述代码等同于这样的SQL语句:

UPDATE `order` SET status = ? , pay_time = ? WHERE id = ? AND status = 1

我们在where条件中除了判断id以外,还加上了status必须为1的条件。如果条件不符(说明订单已支付),则SQL匹配不到数据,根本不会执行。


3.5.兜底方案

虽然我们利用各种机制尽可能增加了消息的可靠性,但也不好说能保证消息100%的可靠。万一真的MQ通知失败该怎么办呢? 有没有其它兜底方案,能够确保订单的支付状态一致呢?

其实思想很简单:既然MQ通知不一定发送到交易服务,那么交易服务就必须自己主动去查询支付状态。这样即便支付服务的MQ通知失败,我们依然能通过主动查询来保证订单状态的一致。 流程如下:

图中黄色线圈起来的部分就是MQ通知失败后的兜底处理方案,由交易服务自己主动去查询支付状态。

不过需要注意的是,交易服务并不知道用户会在什么时候支付,如果查询的时机不正确(比如查询的时候用户正在支付中),可能查询到的支付状态也不正确。 那么问题来了,我们到底该在什么时间主动查询支付状态呢?

这个时间是无法确定的,因此,通常我们采取的措施就是利用定时任务定期查询,例如每隔20秒就查询一次,并判断支付状态。如果发现订单已经支付,则立刻更新订单状态为已支付即可。 定时任务大家之前学习过,具体的实现这里就不再赘述了。

至此,消息可靠性的问题已经解决了。

综上,支付服务与交易服务之间的订单状态一致性是如何保证的?

  • 首先,支付服务会正在用户支付成功以后利用MQ消息通知交易服务,完成订单状态同步。

  • 其次,为了保证MQ消息的可靠性,我们采用了生产者确认机制、消费者确认、消费者失败重试等策略,确保消息投递的可靠性

  • 最后,我们还在交易服务设置了定时任务,定期查询订单支付状态。这样即便MQ通知失败,还可以利用定时任务作为兜底方案,确保订单支付状态的最终一致性。


拓展:应答和发布区别

应答功能属于消费者,消费完消息告诉 RabbitMQ 已经消费成功。可以删了

发布功能属于生产者,生产消息到 RabbitMQ,RabbitMQ 需要告诉生产者是否收到消息。生产者根据该消息来进行考虑要不要再发一次还是怎么样

        其实二者并没有什么关联,应答是为了确保消息真正被用好了,确保传递过来的消息被删除前都是合理处理后再进行删除操作,与生产者无关,它只要管自己要的数据处理好就行;而发布是为了确保生产者自身的消息没有发送错误,确保生产者消息传输的安全性,它不用管消费者处理得怎么样,它只需要管自己的消息都发出去了。


拓展:备份交换机 

        有了 mandatory 参数和回退消息,我们获得了对无法投递消息的感知能力,有机会在生产者的消息无法被投递时发现并处理。但有时候,我们并不知道该如何处理这些无法路由的消息(将回退的消息的处理麻烦),最多打个日志,然后触发报警,再来手动处理。而通过日志来处理这些无法路由的消息是很不优雅的做法,特别是当生产者所在的服务有多台机器的时候,手动复制日志会更加麻烦而且容易出错。而且设置 mandatory 参数会增加生产者的复杂性(对备份消息的处理麻烦),需要添加处理这些被退回的消息的逻辑。如果既不想丢失消息,又不想增加生产者的复杂性,该怎么做呢?

        前面在设置死信队列的文章中,我们提到,可以为队列设置死信交换机来存储那些处理失败的消息,可是这些不可路由消息根本没有机会进入到队列(因为进死信队列的前提是先进入队列中,再进行判断是否进入死信队列,你现在队列都进不了,何来死信队列的说法呢?),因此无法使用死信队列来保存消息。 在 RabbitMQ 中,有一种备份交换机的机制存在,可以很好的应对这个问题。

什么是备份交换机呢?

备份交换机可以理解为 RabbitMQ 中交换机的“备胎”

原理步骤

当我们为某一个交换机声明一个对应的备份交换机时,就是为它创建一个备胎,当交换机接收到一条不可路由消息时,将会把这条消息转发到备份交换机中,由备份交换机来进行转发和处理,通常备份交换机的类型为 Fanout ,这样就能把所有消息都投递到与其绑定的队列中,然后我们在备份交换机下绑定一个队列,这样所有那些原交换机无法被路由的消息,就会都进入这个队列了。当然,我们还可以建立一个报警队列,用独立的消费者来进行监测和报警。

当 RabbitMQ 发现一个消息无法被投递到目标队列时,它会将该消息发送到备份交换机。备份交换机是一种特殊的交换机,可以通过配置让 RabbitMQ 发送无法被路由的消息到指定的备份交换机。

Mandatory 参数与备份交换机可以一起使用的时候,如果两者同时开启,消息究竟何去何从?谁优先级高,经过上面结果显示答案是备份交换机优先级高。


4. 延迟消息

在电商的支付业务中,对于一些库存有限的商品,为了更好的用户体验,通常都会在用户下单时立刻扣减商品库存。例如电影院购票、高铁购票,下单后就会锁定座位资源,其他人无法重复购买。

但是这样就存在一个问题,假如用户下单后一直不付款,就会一直占有库存资源,导致其他客户无法正常交易,最终导致商户利益受损!

因此,电商中通常的做法就是:对于超过一定时间未支付的订单,应该立刻取消订单并释放占用的库存

例如,订单支付超时时间为30分钟,则我们应该在用户下单后的第30分钟检查订单支付状态,如果发现未支付,应该立刻取消订单,释放库存。

但问题来了:如何才能准确的实现在下单后第30分钟去检查支付状态呢?

像这种在一段时间以后才执行的任务,我们称之为延迟任务,而要实现延迟任务,最简单的方案就是利用MQ的延迟消息了。

在RabbitMQ中实现延迟消息也有两种方案:

  • 死信交换机+TTL

  • 延迟消息插件

这一章我们就一起研究下这两种方案的实现方式,以及优缺点。

4.1.死信交换机和延迟消息

首先我们来学习一下基于死信交换机的延迟消息方案。

4.1.1死信交换机

什么是死信?

当一个队列中的消息满足下列情况之一时,可以成为死信(dead letter):

  • 消费者使用basic.rejectbasic.nack声明消费失败,并且消息的requeue参数设置为false

  • 消息是一个过期消息,超时无人消费

  • 要投递的队列消息满了,无法投递

如果一个队列中的消息已经成为死信,并且这个队列通过dead-letter-exchange属性指定了一个交换机,那么队列中的死信就会投递到这个交换机中,而这个交换机就称为死信交换机(Dead Letter Exchange)。而此时加入有队列与死信交换机绑定,则最终死信就会被投递到这个队列中。

死信交换机有什么作用呢?

  1. 收集那些因处理失败而被拒绝的消息

  2. 收集那些因队列满了而被拒绝的消息

  3. 收集因TTL(有效期)到期的消息

4.1.2.延迟消息

前面两种作用场景可以看做是把死信交换机当做一种消息处理的最终兜底方案,与消费者重试时讲的RepublishMessageRecoverer作用类似。

而最后一种场景,大家设想一下这样的场景: 如图,有一组绑定的交换机(ttl.fanout)和队列(ttl.queue)。但是ttl.queue没有消费者监听,而是设定了死信交换机hmall.direct,而队列direct.queue1则与死信交换机绑定,RoutingKey是blue:

image.png

 假如我们现在发送一条消息到ttl.fanout,RoutingKey为blue,并设置消息的有效期为5000毫秒:

image.png

注意:尽管这里的ttl.fanout不需要RoutingKey,但是当消息变为死信并投递到死信交换机时,会沿用之前的RoutingKey,这样hmall.direct才能正确路由消息。

消息肯定会被投递到ttl.queue之后,由于没有消费者,因此消息无人消费。5秒之后,消息的有效期到期,成为死信:

image.png

死信被再次投递到死信交换机hmall.direct,并沿用之前的RoutingKey,也就是blue

image.png

由于direct.queue1hmall.direct绑定的key是blue,因此最终消息被成功路由到direct.queue1,如果此时有消费者与direct.queue1绑定, 也就能成功消费消息了。但此时已经是5秒钟以后了:

image.png

也就是说,publisher发送了一条消息,但最终consumer在5秒后才收到消息。我们成功实现了延迟消息。  

4.1.3.总结

注意: RabbitMQ的消息过期是基于追溯方式来实现的,也就是说当一个消息的TTL到期以后不一定会立刻被移除或投递到死信交换机,而是在消息恰好处于队首时才会被处理。 当队列中消息堆积很多的时候,过期消息可能不会被按时处理,因此你设置的TTL时间不一定准确。

4.2.DelayExchange插件

基于死信队列虽然可以实现延迟消息,但是太麻烦了。因此RabbitMQ社区提供了一个延迟消息插件来实现相同的效果。 官方文档说明: Scheduling Messages with RabbitMQ | RabbitMQ - Blog

4.2.1.下载

插件下载地址: GitHub - rabbitmq/rabbitmq-delayed-message-exchange: Delayed Messaging for RabbitMQ 由于我们安装的MQ是3.8版本,因此这里下载3.8.17版本:

具体的安装教程这里就不再赘述了,网上这种配置类的文章很多,大家可以去搜刮一波

4.2.3.声明延迟交换机

基于注解方式:

  1. @RabbitListener(bindings = @QueueBinding(
  2. value = @Queue(name = "delay.queue", durable = "true"),
  3. exchange = @Exchange(name = "delay.direct", delayed = "true"),
  4. key = "delay"
  5. ))
  6. public void listenDelayMessage(String msg){
  7. log.info("接收到delay.queue的延迟消息:{}", msg);
  8. }

 基于@Bean的方式:

  1. @Slf4j
  2. @Configuration
  3. public class DelayExchangeConfig {
  4. @Bean
  5. public DirectExchange delayExchange(){
  6. return ExchangeBuilder
  7. .directExchange("delay.direct") // 指定交换机类型和名称
  8. .delayed() // 设置delay的属性为true
  9. .durable(true) // 持久化
  10. .build();
  11. }
  12. @Bean
  13. public Queue delayedQueue(){
  14. return new Queue("delay.queue");
  15. }
  16. @Bean
  17. public Binding delayQueueBinding(){
  18. return BindingBuilder.bind(delayedQueue()).to(delayExchange()).with("delay");
  19. }
  20. }

4.2.4.发送延迟消息

发送消息时,必须通过x-delay属性设定延迟时间:

  1. @Test
  2. void testPublisherDelayMessage() {
  3. // 1.创建消息
  4. String message = "hello, delayed message";
  5. // 2.发送消息,利用消息后置处理器添加消息头
  6. rabbitTemplate.convertAndSend("delay.direct", "delay", message, new MessagePostProcessor() {
  7. @Override
  8. public Message postProcessMessage(Message message) throws AmqpException {
  9. // 添加延迟消息属性
  10. message.getMessageProperties().setDelay(5000);
  11. return message;
  12. }
  13. });
  14. }

注意: 延迟消息插件内部会维护一个本地数据库表,同时使用Elang Timers功能实现计时。如果消息的延迟时间设置较长,可能会导致堆积的延迟消息非常多,会带来较大的CPU开销,同时延迟消息的时间会存在误差。 因此,不建议设置延迟时间过长的延迟消息


拓展:优先级队列 

使用场景

        在我们系统中有一个订单催付的场景,我们的客户在天猫下的订单,淘宝会及时将订单推送给我们,如果在用户设定的时间内未付款那么就会给用户推送一条短信提醒,很简单的一个功能对吧。

        但是,tmall 商家对我们来说,肯定是要分大客户和小客户的对吧,比如像苹果,小米这样大商家一年起码能给我们创造很大的利润,所以理应当然,他们的订单必须得到优先处理,而曾经我们的后端系统是使用 redis 来存放的定时轮询,大家都知道 redis 只能用 List 做一个简简单单的消息队列,并不能实现一个优先级的场景,所以订单量大了后采用 RabbitMQ 进行改造和优化,如果发现是大客户的订单给一个相对比较高的消息优先级, 否则就是默认优先级

实现步骤

声明队列的时候添加优先级

设置队列的最大优先级 最大可以设置到 255 官网推荐 1-10 如果设置太高比较吃内存和 CPU

        RabbitMQ的优先级队列将消息的优先级与队列的优先级相结合,以确保高优先级的消息首先被处理。这样做的确切原因是,优先级队列的作用是确保高优先级的消息在队列中具有更高的权重,以便它们更快地被处理。如果只设置了消息的优先级,而没有为队列设置优先级,则消息可能会被放置在具有低优先级的队列中,从而导致高优先级的消息被延迟处理。因此,为队列设置优先级是允许正确的优先级排序的必要步骤。(就是说,你如果想要设置优先级消息,那你只能在优先级队列中操作)

        注意:要等所有的消息都发到MQ队列中才能开放消费者获取消息,因为优先机队列的原理是见给所有的消息再MQ队列中进行排序,将优先级高的消息排序到队列的前端,这样子消费者以获取的就是队列最前的消息,也就是优先级最高的消息


4.5.订单状态同步问题

接下来,我们就在交易服务中利用延迟消息实现订单支付状态的同步。其大概思路如下:

假如订单超时支付时间为30分钟,理论上说我们应该在下单时发送一条延迟消息,延迟时间为30分钟。这样就可以在接收到消息时检验订单支付状态,关闭未支付订单。 但是大多数情况下用户支付都会在1分钟内完成,我们发送的消息却要在MQ中停留30分钟,额外消耗了MQ的资源。因此,我们最好多检测几次订单支付状态,而不是在最后第30分钟才检测。 例如:我们在用户下单后的第10秒、20秒、30秒、45秒、60秒、1分30秒、2分、...30分分别设置延迟消息,如果提前发现订单已经支付,则后续的检测取消即可。 这样就可以有效避免对MQ资源的浪费了。

优化后的实现思路如下:

由于我们要多次发送延迟消息,因此需要先定义一个记录消息延迟时间的消息体,处于通用性考虑,我们将其定义到hm-common模块下:

image.png

  1. @Data
  2. public class MultiDelayMessage<T> {
  3. /**
  4. * 消息体
  5. */
  6. private T data;
  7. /**
  8. * 记录延迟时间的集合
  9. */
  10. private List<Long> delayMillis;
  11. public MultiDelayMessage(T data, List<Long> delayMillis) {
  12. this.data = data;
  13. this.delayMillis = delayMillis;
  14. }
  15. public static <T> MultiDelayMessage<T> of(T data, Long ... delayMillis){
  16. return new MultiDelayMessage<>(data, CollUtils.newArrayList(delayMillis));
  17. }
  18. /**
  19. * 获取并移除下一个延迟时间
  20. * @return 队列中的第一个延迟时间
  21. */
  22. public Long removeNextDelay(){
  23. return delayMillis.remove(0);
  24. }
  25. /**
  26. * 是否还有下一个延迟时间
  27. */
  28. public boolean hasNextDelay(){
  29. return !delayMillis.isEmpty();
  30. }
  31. }

4.5.1.定义常量

无论是消息发送还是接收都是在交易服务完成,因此我们在trade-service中定义一个常量类,用于记录交换机、队列、RoutingKey等常量:

image.png

  1. public interface MqConstants {
  2. String DELAY_EXCHANGE = "trade.delay.topic";
  3. String DELAY_ORDER_QUEUE = "trade.order.delay.queue";
  4. String DELAY_ORDER_ROUTING_KEY = "order.query";
  5. }

4.5.2.抽取共享mq配置

我们将mq的配置抽取到nacos中,方便各个微服务共享配置。 在nacos中定义一个名为shared-mq.xml的配置文件,内容如下:

  1. spring:
  2. rabbitmq:
  3. host: ${hm.mq.host:192.168.150.101} # 主机名
  4. port: ${hm.mq.port:5672} # 端口
  5. virtual-host: ${hm.mq.vhost:/hmall} # 虚拟主机
  6. username: ${hm.mq.un:hmall} # 用户名
  7. password: ${hm.mq.pw:123} # 密码
  8. listener:
  9. simple:
  10. prefetch: 1 # 每次只能获取一条消息,处理完成才能获取下一个消息

这里只添加一些基础配置,至于生产者确认,消费者确认配置则由微服务根据业务自己决定。

trade-service模块添加共享配置:

image.png

4.5.3.改造下单业务

接下来,我们改造下单业务,在下单完成后,发送延迟消息,查询支付状态。

1)引入依赖 在trade-service模块的pom.xml中引入amqp的依赖:

  1. <!--amqp-->
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter-amqp</artifactId>
  5. </dependency>

  2)改造下单业务 修改trade-service模块的com.hmall.trade.service.impl.OrderServiceImpl类的createOrder方法,添加消息发送的代码:

image.png

​​​​4.5.4.编写查询支付状态接口

由于MQ消息处理时需要查询支付状态,因此我们要在pay-service模块定义一个这样的接口,并提供对应的FeignClient. 首先,在hm-api模块定义三个类:

image.png

说明:

  • PayOrderDTO:支付单的数据传输实体

  • PayClient:支付系统的Feign客户端

  • PayClientFallback:支付系统的fallback逻辑

PayOrderDTO代码如下:

  1. @Data
  2. @ApiModel(description = "支付单数据传输实体")
  3. public class PayOrderDTO {
  4. @ApiModelProperty("id")
  5. private Long id;
  6. @ApiModelProperty("业务订单号")
  7. private Long bizOrderNo;
  8. @ApiModelProperty("支付单号")
  9. private Long payOrderNo;
  10. @ApiModelProperty("支付用户id")
  11. private Long bizUserId;
  12. @ApiModelProperty("支付渠道编码")
  13. private String payChannelCode;
  14. @ApiModelProperty("支付金额,单位分")
  15. private Integer amount;
  16. @ApiModelProperty("付类型,1:h5,2:小程序,3:公众号,4:扫码,5:余额支付")
  17. private Integer payType;
  18. @ApiModelProperty("付状态,0:待提交,1:待支付,2:支付超时或取消,3:支付成功")
  19. private Integer status;
  20. @ApiModelProperty("拓展字段,用于传递不同渠道单独处理的字段")
  21. private String expandJson;
  22. @ApiModelProperty("第三方返回业务码")
  23. private String resultCode;
  24. @ApiModelProperty("第三方返回提示信息")
  25. private String resultMsg;
  26. @ApiModelProperty("支付成功时间")
  27. private LocalDateTime paySuccessTime;
  28. @ApiModelProperty("支付超时时间")
  29. private LocalDateTime payOverTime;
  30. @ApiModelProperty("支付二维码链接")
  31. private String qrCodeUrl;
  32. @ApiModelProperty("创建时间")
  33. private LocalDateTime createTime;
  34. @ApiModelProperty("更新时间")
  35. private LocalDateTime updateTime;
  36. }

PayClient代码如下:

  1. @FeignClient(value = "pay-service", fallbackFactory = PayClientFallback.class)
  2. public interface PayClient {
  3. /**
  4. * 根据交易订单id查询支付单
  5. * @param id 业务订单id
  6. * @return 支付单信息
  7. */
  8. @GetMapping("/pay-orders/biz/{id}")
  9. PayOrderDTO queryPayOrderByBizOrderNo(@PathVariable("id") Long id);
  10. }

PayClientFallback代码如下:

  1. @Slf4j
  2. public class PayClientFallback implements FallbackFactory<PayClient> {
  3. @Override
  4. public PayClient create(Throwable cause) {
  5. return new PayClient() {
  6. @Override
  7. public PayOrderDTO queryPayOrderByBizOrderNo(Long id) {
  8. return null;
  9. }
  10. };
  11. }
  12. }

最后,在pay-service模块的PayController中实现该接口:

  1. @ApiOperation("根据id查询支付单")
  2. @GetMapping("/biz/{id}")
  3. public PayOrderDTO queryPayOrderByBizOrderNo(@PathVariable("id") Long id){
  4. PayOrder payOrder = payOrderService.lambdaQuery().eq(PayOrder::getBizOrderNo, id).one();
  5. return BeanUtils.copyBean(payOrder, PayOrderDTO.class);
  6. }

4.5.5.消息监听

接下来,我们在trader-service编写一个监听器,监听延迟消息,查询订单支付状态:

image.png

代码如下:

  1. @Slf4j
  2. @Component
  3. @RequiredArgsConstructor
  4. public class OrderStatusListener {
  5. private final IOrderService orderService;
  6. private final PayClient payClient;
  7. private final RabbitTemplate rabbitTemplate;
  8. @RabbitListener(bindings = @QueueBinding(
  9. value = @Queue(name = MqConstants.DELAY_ORDER_QUEUE, durable = "true"),
  10. exchange = @Exchange(name = MqConstants.DELAY_EXCHANGE, type = ExchangeTypes.TOPIC),
  11. key = MqConstants.DELAY_ORDER_ROUTING_KEY
  12. ))
  13. public void listenOrderCheckDelayMessage(MultiDelayMessage<Long> msg) {
  14. // 1.获取消息中的订单id
  15. Long orderId = msg.getData();
  16. // 2.查询订单,判断状态:1是未支付,大于1则是已支付或已关闭
  17. Order order = orderService.getById(orderId);
  18. if (order == null || order.getStatus() > 1) {
  19. // 订单不存在或交易已经结束,放弃处理
  20. return;
  21. }
  22. // 3.可能是未支付,查询支付服务
  23. PayOrderDTO payOrder = payClient.queryPayOrderByBizOrderNo(orderId);
  24. if (payOrder != null && payOrder.getStatus() == 3) {
  25. // 支付成功,更新订单状态
  26. orderService.markOrderPaySuccess(orderId);
  27. return;
  28. }
  29. // 4.确定未支付,判断是否还有剩余延迟时间
  30. if (msg.hasNextDelay()) {
  31. // 4.1.有延迟时间,需要重发延迟消息,先获取延迟时间的int值
  32. int delayVal = msg.removeNextDelay().intValue();
  33. // 4.2.发送延迟消息
  34. rabbitTemplate.convertAndSend(MqConstants.DELAY_EXCHANGE, MqConstants.DELAY_ORDER_ROUTING_KEY, msg,
  35. message -> {
  36. message.getMessageProperties().setDelay(delayVal);
  37. return message;
  38. });
  39. return;
  40. }
  41. // 5.没有剩余延迟时间了,说明订单超时未支付,需要取消订单
  42. orderService.cancelOrder(orderId);
  43. }
  44. }

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/AllinToyou/article/detail/514328
推荐阅读
相关标签
  

闽ICP备14008679号