当前位置：首页 > article >正文

Spring Boot: 使用 @Transactional 和 TransactionSynchronization 在事务提交后发送消息到 MQ

article 2026/4/29 2:16:12

Spring Boot: 使用 `@Transactional` 和 `TransactionSynchronization` 在事务提交后发送消息到 MQ

在微服务架构中，确保消息的可靠性和一致性非常重要，尤其是在涉及到分布式事务的场景中。本文将演示如何使用 Spring Boot 的事务机制和 TransactionSynchronization 来在事务提交后发送消息到消息队列（MQ）。这样可以保证只有在事务成功提交后，消息才会被发送。

背景

在处理数据更新的同时，我们可能需要将一些数据变更的消息推送到消息队列（例如 RabbitMQ、Kafka）。为了保证数据和消息的一致性，通常需要在事务提交后再发送消息。Spring 的 @Transactional 注解和 TransactionSynchronization 机制非常适合处理这种需求。

我们将通过一个简单的示例，演示如何在事务提交后发送消息。我们将使用 RabbitMQ 作为消息队列，但这个方法可以扩展到其他类型的 MQ。

核心思想

事务同步： 使用 TransactionSynchronizationManager 注册一个事务同步回调，确保消息在事务提交后被发送。
afterCommit 回调： 该回调将在事务成功提交后执行，确保只有在数据操作成功时才会发送消息。

步骤概述

定义一个服务： 使用 @Transactional 注解来确保数据操作在事务中进行。
注册事务同步回调： 在事务内注册一个同步回调，确保在事务提交后发送消息。
消息发送： 使用 RabbitTemplate 将消息发送到 RabbitMQ 或其他消息队列。

示例：使用 `TransactionSynchronization` 在事务提交后发送消息

1. 配置 RabbitMQ

首先，我们需要配置 RabbitMQ 的连接。我们将使用 Spring Boot 提供的 RabbitTemplate 来发送消息。

@Configuration
public class RabbitConfig {@Beanpublic Queue orderQueue() {return new Queue("orderQueue", false);}@Beanpublic RabbitTemplate rabbitTemplate(ConnectionFactory connectionFactory) {return new RabbitTemplate(connectionFactory);}
}

2. 定义业务服务

接下来，我们创建一个业务服务 MyService，它将在事务提交后发送消息到消息队列。在该服务中，我们使用 @Transactional 来管理事务，并通过 TransactionSynchronizationManager.registerSynchronization 注册一个事务同步回调，确保在事务提交成功后才发送消息。

@Service
public class MyService {@Autowiredprivate RabbitTemplate rabbitTemplate;@Transactionalpublic void doSomething() {// 执行一些业务逻辑，例如保存数据库记录System.out.println("Executing business logic...");// 注册事务同步回调TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {@Overridepublic void afterCommit() {// 事务提交后发送 MQ 消息rabbitTemplate.convertAndSend("exchangeName", "routingKey", "Message after commit");System.out.println("Message sent after commit!");}@Overridepublic void beforeCompletion() {// 可选：在事务完成前做一些操作}});}
}

3. 处理事务和消息

在 doSomething() 方法中，我们进行了数据库操作（模拟的业务逻辑），并注册了一个事务同步回调。这个回调会在事务提交成功后执行，发送一条消息到 RabbitMQ。消息的发送是在事务提交后进行的，因此我们确保了消息与数据的操作一致性。

事务提交后才发送消息： 只有在事务提交成功后，afterCommit 方法中的消息发送操作才会被执行。
失败回滚： 如果事务执行失败，消息不会被发送，因为事务会回滚，afterCommit 方法不会被调用。

4. 控制事务提交和回滚

你可以在业务逻辑中使用 @Transactional 注解来管理事务。当事务提交时，注册的同步回调将被触发，从而发送消息。示例如下：

@RestController
@RequestMapping("/orders")
public class OrderController {@Autowiredprivate MyService myService;@PostMapping("/create")public ResponseEntity<String> createOrder(@RequestBody Order order) {try {myService.doSomething();return ResponseEntity.ok("Order processed successfully");} catch (Exception e) {return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Order processing failed");}}
}

扩展：多个事务提交，多个不同消息的例子

假设我们需要在一个方法中处理多个不同类型的事务，并根据不同的条件发送不同的消息。我们可以扩展上述示例，实现多个事务和不同消息发送。

@Service
public class MyService {@Autowiredprivate RabbitTemplate rabbitTemplate;@Transactionalpublic void doSomethingMultipleOrders(Order order1, Order order2) {// 处理订单1System.out.println("Processing order 1...");// 注册事务同步回调，发送订单1的消息TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {@Overridepublic void afterCommit() {rabbitTemplate.convertAndSend("exchangeName", "routingKey1", "Order 1 message after commit");System.out.println("Order 1 message sent after commit!");}});// 处理订单2System.out.println("Processing order 2...");// 注册事务同步回调，发送订单2的消息TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {@Overridepublic void afterCommit() {rabbitTemplate.convertAndSend("exchangeName", "routingKey2", "Order 2 message after commit");System.out.println("Order 2 message sent after commit!");}});}
}

在上面的代码中，我们为两个订单分别注册了事务同步回调。每个回调在事务提交后发送不同的消息。这可以扩展为多个事务提交，针对每个不同的事务执行不同的消息发送操作。

总结

通过使用 Spring 的 @Transactional 注解和 TransactionSynchronizationManager，我们可以确保只有在事务提交后才会发送消息。这个方法可以用于各种 MQ 实现（如 RabbitMQ、Kafka），并且能保证事务和消息的顺序一致性。在实际应用中，这种方法可以帮助我们有效避免消息丢失和数据不一致的问题。

希望本篇博客能够帮助你理解如何在 Spring Boot 中使用事务机制来确保在事务提交后发送消息，并且能够处理多个事务和多个消息的情况。