springboot+rocketmq（7）:实现事务消息

最新推荐文章于 2025-07-09 09:06:42 发布

12程序猿

最新推荐文章于 2025-07-09 09:06:42 发布

阅读量2.6k

点赞数 2

CC 4.0 BY-SA版权

分类专栏： mq SpringBoot 文章标签： java-rocketmq spring boot rocketmq

本文链接：https://blog.csdn.net/qq_26383975/article/details/125679425

本文详细介绍了SpringBoot结合RocketMQ实现事务消息的原理、使用规则及配置过程，包括分布式事务概念、RocketMQ事务消息的执行流程、生产者和消费者的创建，以及事务消息的测试案例。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、概念

1.分布式事务

分布式事务通俗来说，一次操作由若干分支组成，这些分支操作分属于不同的应用，分布在不同的服务器上，分布式事务需要保证这些操作要么全部成功，要么全部失败，分支事务与普通事务一样，就是为了保证操作结果的一致性。

2.事务消息

rocketMQ 事务消息是指应用本地事务和发送消息操作可以被定义到全局事务中，要么同时成功，要么同时失败。

3.半事务消息

暂不能投递的消息，生产者已经成功地将消息发送到了消息队列RocketMQ版服务端，但是消息队列RocketMQ版服务端未收到生产者对消息的二次确认，此时该消息被标记成“暂不能投递”状态，处于该种状态下的消息即半事务消息。

4.消息回查

由于网络闪断、生产者应用重启等原因，导致某条事务消息的二次确认丢失，消息队列RocketMQ版服务端通过扫描发现某条消息长期处于“半事务消息”时，需要主动向消息生产者询问该消息的最终状态（Commit或是Rollback），该询问过程即消息回查。

5.本地事务状态

生产者回调操作执行的结果为本地事务状态。其会发送给TC，而TC会在发送给TM，TM会根据TC发送过来的本地事务状态来决定全局事务确认指令。

RocketMQ 的事务消息分为3种状态，分别是提交状态、回滚状态、未知状态。
TransactionStatus.CommitTransaction: 提交事务，它允许消费者消费此消息。
TransactionStatus.RollbackTransaction: 回滚事务，它代表该消息将被删除，不允许被消费。
TransactionStatus.Unknown: 未知状态，它代表需要检查消息队列来确定状态。

二、RocketMQ 事务消息的原理

RocketMQ 事务消息的执行流程如下：
在这里插入图片描述
事务消息发送步骤如下：

①生产者将半事务消息发送至消息队列RocketMQ版服务端。
②消息队列RocketMQ版服务端将消息持久化成功之后，向生产者返回Ack确认消息已经发送成功，此时消息为半事务消息。
③生产者开始执行本地事务逻辑。
④生产者根据本地事务执行结果向服务端提交二次确认结果（Commit或是Rollback），服务端收到确认结果后处理逻辑如下：

二次确认结果为Commit：服务端将半事务消息标记为可投递，并投递给消费者。
二次确认结果为Rollback：服务端将回滚事务，不会将半事务消息投递给消费者。

⑤在断网或者是生产者应用重启的特殊情况下，若服务端未收到发送者提交的二次确认结果，或服务端收到的二次确认结果为Unknown未知状态，经过固定时间后，服务端将对消息生产者即生产者集群中任一生产者实例发起消息回查。

事务消息回查步骤如下：

(1)生产者收到消息回查后，需要检查对应消息的本地事务执行的最终结果。
(2)生产者根据检查得到的本地事务的最终状态再次提交二次确认，服务端仍按照步骤4对半事务消息进行处理。

备注：本地事务的回滚依赖于本地DB的ACID特性，订阅方的成功消费由 MQ Server 的失败重试机制进行保证。

三、使用规则

1.生产消息规则

事务消息发送完成本地事务后，可在execute方法中返回以下三种状态：

TransactionStatus.CommitTransaction:提交事务，允许消费者消费该消息。
TransactionStatus.RollbackTransation:回滚事务，消息将被丢弃不允许消费。
TransactionStatus.Unknow:暂时无法判断状态，等待固定时间以后消息队列RocketMQ版服务端根据回查规则向生产者进行消息回查

通过ONSFactory.createTransactionProducer创建事务消息的Producer时必须指定LocalTransactionChecker的实现类，处理异常情况下事务消息的回查。

回查规则：本地事务执行完成后，若消息队列RocketMQ版服务端收到的本地事务返回状态为TransactionStatus.Unknow，或生产者应用退出导致本地事务未提交任何状态。则消息队列RocketMQ版服务端会向消息生产者发起事务回查，第一次回查后仍未获取到事务状态，则之后每隔一段时间会再次回查。

回查间隔时间：系统默认每隔30秒发起一次定时任务，对未提交的半事务消息进行回查，共持续12小时。
第一次消息回查最快时间：该参数支持自定义设置。若指定消息未达到设置的最快回查时间前，系统默认每隔30秒一次的回查任务不会检查该消息。

2.消费消息规则

事务消息的Group ID不能与其他类型消息的Group ID共用。与其他类型的消息不同，事务消息有回查机制，回查时消息队列RocketMQ版服务端会根据Group ID去查询生产者客户端。

四、Springboot 整合 RocketMQ 实现事务消息

4.1 启动 RocketMQ 服务端

RocketMQ的安装与部署请参考这篇文章：https://blog.csdn.net/qq_26383975/article/details/125337809

4.2 添加rocketmq依赖

创建Springboot项目，添加rockermq 依赖

<!--rocketMq依赖-->
<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-spring-boot-starter</artifactId>
    <version>2.2.1</version>
</dependency>

4.3 配置rocketmq

# 端口
server:
  port: 8083

# 配置 rocketmq
rocketmq:
  name-server: 127.0.0.1:9876
  #生产者
  producer:
    #生产者组名，规定在一个应用里面必须唯一
    group: group1
    #消息发送的超时时间 默认3000ms
    send-message-timeout: 30