Java 后端 / 系统课时
使用应用事件解耦模块
使用应用事件解耦模块
当订单模块完成业务操作后,库存、通知和审计模块往往都要响应。直接互相调用会扩大依赖范围。本课使用 ApplicationEventPublisher 发布领域事实,通过监听器完成模块内解耦,并辨析同步、异步与事务监听的执行边界。
学习目标
- 定义并发布不可变的应用事件
- 使用
@EventListener订阅事件并验证执行顺序 - 判断同步、异步和事务监听器的适用场景
为什么使用应用事件
应用事件适合表达“某件事已经发生”,例如“订单已创建”,而不是向另一个模块下达“扣减库存”这样的命令。发布者只依赖事件类型,不需要知道有多少监听器,也不需要持有监听器对象。
事件通常设计为不可变数据,只携带监听器完成工作所需的最小信息。不要直接放入可变实体或懒加载对象,否则监听器可能读取到被后续代码修改的状态。
发布与监听的执行链路

Spring 默认通过应用上下文中的事件多播器分发事件,普通监听器在发布线程中同步执行。因此,监听器抛出的运行时异常会影响发布调用,慢监听器也会拉长原业务方法的耗时。异步与否不是事件对象的属性,而由监听器或多播器的执行策略决定。
完成一个可运行示例
下面的类可直接放入已有的 Spring Boot 3 项目。事件机制来自 Spring Context,不需要额外引入消息中间件。
package com.example.eventdemo;
import java.time.Instant;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationEventPublisher;
import org.springframework.context.annotation.Bean;
import org.springframework.context.event.EventListener;
@SpringBootApplication
public class EventDemoApplication {
public static void main(String[] args) {
SpringApplication.run(EventDemoApplication.class, args);
}
@Bean
OrderService orderService(ApplicationEventPublisher publisher) {
return new OrderService(publisher);
}
@Bean
OrderEventListener orderEventListener() {
return new OrderEventListener();
}
@Bean
CommandLineRunner demo(OrderService orderService) {
return args -> {
System.out.println("1. 准备提交订单");
orderService.placeOrder("A100");
System.out.println("4. publishEvent 已返回");
};
}
public record OrderCreatedEvent(String orderNo, Instant occurredAt) {
}
static final class OrderService {
private final ApplicationEventPublisher publisher;
OrderService(ApplicationEventPublisher publisher) {
this.publisher = publisher;
}
void placeOrder(String orderNo) {
System.out.println("2. 订单已保存:" + orderNo);
publisher.publishEvent(new OrderCreatedEvent(orderNo, Instant.now()));
}
}
static final class OrderEventListener {
@EventListener
void reserveInventory(OrderCreatedEvent event) {
System.out.println("3. 库存模块收到事件:" + event.orderNo());
}
}
}预期输出
1. 准备提交订单
2. 订单已保存:A100
3. 库存模块收到事件:A100
4. publishEvent 已返回第 3 行出现在第 4 行之前,证明默认监听器在 publishEvent 返回前已经执行完毕。
选择异步或事务监听
当监听逻辑耗时较长且不要求调用方等待时,可以启用异步支持,并在特定监听器上添加 @Async。下面是片段示例,依赖 Spring 的异步方法执行能力。
@Configuration
@EnableAsync
class AsyncEventConfig {
}
@Component
class NotificationListener {
@Async
@EventListener
public void sendNotification(EventDemoApplication.OrderCreatedEvent event) {
// 在任务执行器线程中处理,异常不会直接抛回发布者
}
}异步监听器不能依赖发布线程中的 ThreadLocal、日志上下文或未提交事务。若监听动作必须在数据库事务成功提交后执行,应使用 @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT);若事务回滚,提交后监听器不会被调用。
明确使用边界
应用事件解决的是单个 Spring 应用内部的模块协作,不提供消息持久化、跨进程投递、消费确认或失败重放。监听器执行失败需要由应用自行设计异常处理与补偿。
当业务要求服务间通信、削峰、重试或可追溯消费时,应改用 Kafka 等消息中间件,而不是把应用事件当作可靠消息队列。