Java 后端 / 系统课时

处理事务提交后的事件

处理事务提交后的事件

本课解决“数据库事务还没提交,下游就开始消费”的时序问题。你会用 Spring 的事务事件监听机制,把附加动作推迟到事务成功提交之后执行,同时明确它与可靠消息投递之间的边界。

学习目标

  • 理解普通事件监听与事务提交时机的差异。
  • 掌握 @TransactionalEventListener 的 AFTER_COMMIT 用法。
  • 能判断提交后事件的适用场景,以及它为什么不能替代可靠消息方案。

先看清事件发生的时机

在 @Transactional 方法中调用 publishEvent,并不代表数据库已经提交。普通 @EventListener 默认在事件发布线程中同步执行,因此监听器完全可能发生在数据库 commit 之前。

典型风险是:业务方法写入订单 → 发布“订单已创建”事件 → 监听器调用下游 → 下游开始处理 → 外层事务随后回滚。这样,下游已经执行的动作就失去了最终成立的数据库事实。

事务事件在提交前后的触发时机

使用 AFTER_COMMIT 监听事件

Spring 的 @TransactionalEventListener 可以把监听器绑定到事务生命周期。phase = TransactionPhase.AFTER_COMMIT 表示:发布事件的事务成功提交后才调用监听器;事务回滚时不调用。下面是片段示例,依赖项目中已有可用的 OrderRepository Bean,并把缓存刷新作为提交后的非关键动作。

java
package com.example.order;

import org.springframework.context.ApplicationEventPublisher;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.transaction.event.TransactionPhase;
import org.springframework.transaction.event.TransactionalEventListener;

@Service
public class OrderService {
    private final OrderRepository orderRepository;
    private final ApplicationEventPublisher eventPublisher;

    public OrderService(OrderRepository orderRepository,
                        ApplicationEventPublisher eventPublisher) {
        this.orderRepository = orderRepository;
        this.eventPublisher = eventPublisher;
    }

    @Transactional
    public void createOrder(Long orderId) {
        orderRepository.insert(orderId);
        // 这里只发布应用事件,监听逻辑等待事务提交结果。
        eventPublisher.publishEvent(new OrderCreatedEvent(orderId));
    }
}

record OrderCreatedEvent(Long orderId) {}

@Component
class OrderCreatedListener {
    @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
    public void onOrderCreated(OrderCreatedEvent event) {
        System.out.println("refresh cache: order=" + event.orderId());
    }
}

interface OrderRepository {
    void insert(Long orderId);
}

预期结果

text
事务提交成功后输出:refresh cache: order=<ID>
事务最终回滚时:不输出该监听结果

其中 <ID> 代表实际订单 ID。还要注意:如果发布事件时没有活动事务,事务事件监听器默认不会执行;只有明确设置 fallbackExecution = true,才会在无事务场景下直接处理事件。

提交后的事务边界

AFTER_COMMIT 触发时,原事务已经完成提交,不能把监听器理解为“继续处在原数据库事务里”。Spring 此时可能仍能访问与原事务关联的资源,但监听器中的新数据库修改不会自动获得一次新的事务提交机会。

如果监听器必须修改数据库,应把写操作放到独立 Bean 中,并显式使用 Propagation.REQUIRES_NEW 开启新事务。这样,新写入拥有独立的提交、回滚和异常边界,不会把提交后的工作错误地寄托在已经结束的事务上。

它不是可靠消息投递机制

AFTER_COMMIT 只解决“什么时候开始执行监听器”,不保证监听器产生的副作用最终成功。监听器调用 HTTP 可能超时,发送消息时 Broker 可能不可用,应用也可能在数据库提交之后、监听动作完成之前崩溃。

它适合缓存清理、非关键派生状态刷新、允许偶发丢失的应用内通知等场景。即使再结合 @Async,也只是把执行切换到线程池,并不会自动获得持久化、重试和故障恢复能力。

如果业务要求“数据库一旦提交,这条事件就必须最终送达”,就需要把待发送事件作为持久化事实保存下来,再由独立流程可靠投递,例如 Outbox。判断标准很简单:事件丢失会造成业务事实缺失时,不要把 AFTER_COMMIT 当作可靠消息机制。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

处理事务提交后的事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通