SpringCloud Alibaba微服务实战三十二 - 集成RocketMQ实现分布式事务

《一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码》，点击传送门，即可获取！

RocketMQ本身已经支持事务消息，如果你们项目使用了RocketMQ，可以直接借助RocketMQ的事务消息实现分布式事务，我们先看一下RocketMQ事务消息的原理然后再借助RocketMQ来实现分布式事务。

RocketMQ采用了2PC的思想来实现了提交事务消息，同时增加一个补偿逻辑来处理二阶段超时或者失败的消息，如下图所示。

RocketMQ实现事务消息主要分为两个阶段：正常事务的发送及提交、事务信息的补偿流程

整体流程为：

• 正常事务发送与提交阶段

1、生产者发送一个半消息给MQServer（半消息是指消费者暂时不能消费的消息）

2、服务端响应消息写入结果，半消息发送成功

3、开始执行本地事务

4、根据本地事务的执行状态执行Commit或者Rollback操作

• 事务信息的补偿流程

1、如果MQServer长时间没收到本地事务的执行状态会向生产者发起一个确认回查的操作请求

2、生产者收到确认回查请求后，检查本地事务的执行状态

3、根据检查后的结果执行Commit或者Rollback操作

补偿阶段主要是用于解决生产者在发送Commit或者Rollback操作时发生超时或失败的情况。

RocketMQ事务流程关键

1. 事务消息在一阶段对用户不可见

事务消息相对普通消息最大的特点就是一阶段发送的消息对用户是不可见的，也就是说消费者不能直接消费。这里RocketMQ的实现方法是原消息的主题与消息消费队列，然后把主题改成RMQ_SYS_TRANS_HALF_TOPIC ，这样由于消费者没有订阅这个主题，所以不会被消费。

2. 如何处理第二阶段的失败消息？

在本地事务执行完成后会向MQServer发送Commit或Rollback操作，此时如果在发送消息的时候生产者出故障了，那么要保证这条消息最终被消费，MQServer会像服务端发送回查请求，确认本地事务的执行状态。

当然了rocketmq并不会无休止的的信息事务状态回查，默认回查15次，如果15次回查还是无法得知事务状态，RocketMQ默认回滚该消息。

3. 消息状态

事务消息有三种状态：

TransactionStatus.CommitTransaction：提交事务消息，消费者可以消费此消息

TransactionStatus.RollbackTransaction： 回滚事务，它代表该消息将被删除，不允许被消费。

TransactionStatus.Unknown ：中间状态，它代表需要检查消息队列来确定状态。

代码实现

---

业务需求：用户请求订单微服务 order-service 接口删除订单（退货），删除订单时需要调用 account-service的方法给账户增加余额，一个典型的分布式事务问题。

基础配置

在开始代码之前首先需要搭建好的RocketMQ环境，如果有不会的可以参考下面这篇文章：

http://javadaily.cn/articles/2020/04/07/1586248405351.html 非常详细

• 在Order-Service和Account-Service中引入Rocket消息组件

org.apache.rocketmq

rocketmq-spring-boot-starter

• 在配置中心添加RocketMQ的相关配置

rocketmq:

name-server: xxx.xx.x.xx:9876

producer:

group: cloud-group

• 在OrderService服务中建立一张事务日志表rocketmq_transaction_log（作用稍后说）

发送半消息

Order-Service作为分布式事务开始的入口，在Service层我们给RocketMQ发送一条半消息

• OrderController入口

/**

• 根据订单号删除订单

• @param orderNo 订单编号

*/

@PostMapping(“/order/delete”)

public ResultData delete(@RequestParam String orderNo){

log.info(“delete order id is {}”,orderNo);

orderService.delete(orderNo);

return ResultData.success(“订单删除成功”);

}

直接调用orderService的delete方法

• OrderServiceImpl业务逻辑

@Override

public void delete(String orderNo) {

Order order = orderMapper.selectByNo(orderNo);

//如果订单存在且状态为有效，进行业务处理

if (order != null && CloudConstant.VALID_STATUS.equals(order.getStatus())) {

String transactionId = UUID.randomUUID().toString();

//如果可以删除订单则发送消息给rocketmq，让用户中心消费消息

rocketMQTemplate.sendMessageInTransaction(“add-amount”,

MessageBuilder.withPayload(

UserAddMoneyDTO.builder()

.userCode(order.getAccountCode())

.amount(order.getAmount())

.build()

)

.setHeader(RocketMQHeaders.TRANSACTION_ID, transactionId)

.setHeader(“order_id”,order.getId())

.build()

,order

);

}

}

首先校验一下订单状态，然后使用rocketMQTemplate.sendMessageInTransaction()发送事务消息。

sendMessageInTransaction方法有三个参数：

• destination：目的地(主题)，这里发送给add-amount 这个topic

• message：发送给消费者的消息体，需要使用 MessageBuilder.withPayload() 来构建消息

• arg：参数

注意，这里我们生成了一个transactionId，并放在header中跟消息一起发送（这里实际也可以构造成一个对象，放在arg里进行发送），作用后面再讲！

• 消息封装实体UserAddMoneyDTO

@Data

@NoArgsConstructor

@AllArgsConstructor

@Builder

public class UserAddMoneyDTO {

/**

• 用户编码

*/

private String userCode;

/**

• 金额

*/

private BigDecimal amount;

}

这个类生产这和消费者都需要用到，所以我直接丢到common包中，大家根据项目实际情况决定放哪。

执行本地事务与回查

MQServer收到半消息后会告诉生产者order-service确认收到半消息，这时候order-service需要执行本地事务，执行完本地事务后再告诉MQServer本地事务的执行状态，确认此消息究竟是Commit还是Rollback。

RocketMQ提供了 RocketMQLocalTransactionListener 接口，本地事务监听器，这个接口类的实现如下：

第一个方法executeLocalTransaction 为执行本地事务；

第二个方法checkLocalTransaction 为检查本地事务的执行状态，也就是回查动作。

我们需要实现RocketMQLocalTransactionListener接口，在executeLocalTransaction方法中执行本地事务，在执行checkLocalTransaction回查方法时告诉RocketMQ到底该提交还是回滚。

这里大家思考一个问题，本地事务已经执行完成了，怎么去回查本地事务的执行结果呢？

答案如下：我们可以在执行本地事务的时候同时生成一条事务日志，让本地事务与日志事务在同一个方法中，同时添加@Transactional 注解，保证两个操作事务是一个原子操作。这样如果事务日志表中有这个本地事务的信息，那就代表本地事务执行成功，需要Commit，相反如果没有对应的事务日志，则表示执行失败，需要Rollback。这就是为什么我们上面在OrderService中需要建立一张事务日志表的原因。

• 实现RocketMQLocalTransactionListener接口，完成事务执行逻辑

/**

• 监听事务消息

• @author javadaily

*/

@Slf4j

@RocketMQTransactionListener

@RequiredArgsConstructor(onConstructor = @__(@Autowired))

public class AddUserAmountListener implements RocketMQLocalTransactionListener {

private final OrderService orderService;

private final RocketMqTransactionLogMapper rocketMqTransactionLogMapper;

/**

• 执行本地事务

*/

@Override

public RocketMQLocalTransactionState executeLocalTransaction(Message message, Object arg) {

log.info(“执行本地事务”);

MessageHeaders headers = message.getHeaders();

//获取事务ID

String transactionId = (String) headers.get(RocketMQHeaders.TRANSACTION_ID);

Integer orderId = Integer.valueOf((String)headers.get(“order_id”));

log.info(“transactionId is {}, orderId is {}”,transactionId,orderId);

try{

//执行本地事务，并记录日志

orderService.changeStatuswithRocketMqLog(orderId, CloudConstant.INVALID_STATUS,transactionId);

//执行成功，可以提交事务

return RocketMQLocalTransactionState.COMMIT;

}catch (Exception e){

return RocketMQLocalTransactionState.ROLLBACK;

}

}

/**

• 本地事务的检查，检查本地事务是否成功

*/

@Override

public RocketMQLocalTransactionState checkLocalTransaction(Message message) {

MessageHeaders headers = message.getHeaders();

//获取事务ID

String transactionId = (String) headers.get(RocketMQHeaders.TRANSACTION_ID);

log.info(“检查本地事务,事务ID:{}”,transactionId);

//根据事务id从日志表检索

QueryWrapper queryWrapper = new QueryWrapper<>();

queryWrapper.eq(“transaction_id”,transactionId);

RocketmqTransactionLog rocketmqTransactionLog = rocketMqTransactionLogMapper.selectOne(queryWrapper);

if(null != rocketmqTransactionLog){

return RocketMQLocalTransactionState.COMMIT;

}

return RocketMQLocalTransactionState.ROLLBACK;

最后

我想问下大家当初选择做程序员的初衷是什么？有思考过这个问题吗？高薪？热爱？

既然入了这行就应该知道，这个行业是靠本事吃饭的，你想要拿高薪没有问题，请好好磨练自己的技术，不要抱怨。有的人通过培训可以让自己成长，有些人可以通过自律强大的自学能力成长，如果你两者都不占，还怎么拿高薪？

架构师是很多程序员的职业目标，一个好的架构师是不愁所谓的35岁高龄门槛的，到了那个时候，照样大把的企业挖他。为什么很多人想进阿里巴巴，无非不是福利待遇好以及优质的人脉资源，这对个人职业发展是有非常大帮助的。

如果你也想成为一名好的架构师，那或许这份Java核心架构笔记你需要阅读阅读，希望能够对你的职业发展有所帮助。

中高级开发必知必会：

《一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码》，点击传送门，即可获取！
下大家当初选择做程序员的初衷是什么？有思考过这个问题吗？高薪？热爱？

既然入了这行就应该知道，这个行业是靠本事吃饭的，你想要拿高薪没有问题，请好好磨练自己的技术，不要抱怨。有的人通过培训可以让自己成长，有些人可以通过自律强大的自学能力成长，如果你两者都不占，还怎么拿高薪？

架构师是很多程序员的职业目标，一个好的架构师是不愁所谓的35岁高龄门槛的，到了那个时候，照样大把的企业挖他。为什么很多人想进阿里巴巴，无非不是福利待遇好以及优质的人脉资源，这对个人职业发展是有非常大帮助的。

如果你也想成为一名好的架构师，那或许这份Java核心架构笔记你需要阅读阅读，希望能够对你的职业发展有所帮助。

中高级开发必知必会：

[外链图片转存中…(img-5YyZNe68-1714760026298)]

《一线大厂Java面试题解析+核心总结学习笔记+最新讲解视频+实战项目源码》，点击传送门，即可获取！