对于最新的稳定版本，请使用 Spring Framework 6.2.0！spring-doc.cn

事务绑定事件

从 Spring 4.2 开始，事件的侦听器可以绑定到事务的某个阶段。典型的示例是在事务成功完成时处理事件。这样做可以更灵活地使用事件，当当前 transaction 实际上对侦听器很重要。spring-doc.cn

您可以使用注释注册常规事件侦听器。如果需要将其绑定到事务，请使用 . 执行此操作时，默认情况下，侦听器将绑定到事务的提交阶段。@EventListener@TransactionalEventListenerspring-doc.cn

下一个示例显示了这个概念。假设组件发布 order-created 事件，并且我们想要定义一个侦听器，该侦听器应该只处理该事件一次已成功提交已发布的事务。以下内容 example 设置这样的事件侦听器：spring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

@Component
public class MyComponent {

	@TransactionalEventListener
	public void handleOrderCreatedEvent(CreationEvent<Order> creationEvent) {
		// ...
	}
}

@Component
class MyComponent {

	@TransactionalEventListener
	fun handleOrderCreatedEvent(creationEvent: CreationEvent<Order>) {
		// ...
	}
}

该注解公开了一个属性，该属性允许您自定义侦听器应绑定到的事务阶段。有效阶段是，（default），以及聚合事务完成（无论是提交还是回滚）。@TransactionalEventListenerphaseBEFORE_COMMITAFTER_COMMITAFTER_ROLLBACKAFTER_COMPLETIONspring-doc.cn

如果没有事务正在运行，则根本不会调用侦听器，因为我们无法遵循必需的语义。但是，您可以通过将 Comments 的属性设置为来覆盖该行为。fallbackExecutiontruespring-doc.cn

@TransactionalEventListener仅适用于由管理的线程绑定事务。Management 的反应式事务使用 Reactor 上下文而不是线程本地属性，因此从事件侦听器，则没有它可以参与的兼容活动事务。PlatformTransactionManagerReactiveTransactionManagerspring-doc.cn