Spring Boot 项目启动时监听器调用详解与实战指南

在 Spring Boot 应用中，监听器（Listeners）是响应应用生命周期事件的核心机制。通过监听器，开发者可以在应用启动、运行或关闭的不同阶段插入自定义逻辑，例如初始化资源、预热缓存或监控状态。本文将深入解析 Spring Boot 启动过程中涉及的监听器类型、事件触发顺序及其实现方式，并提供代码示例与最佳实践。

一、Spring Boot 监听器的核心事件类型

Spring Boot 的事件体系基于 ApplicationEvent 和 ApplicationListener，分为 内置系统事件 和 自定义事件 两类。

1. 内置系统事件

Spring Boot 在启动过程中会依次触发以下关键事件：

ApplicationStartingEvent
- 触发时机：应用启动，但尚未进行任何配置或刷新上下文。
- 用途：适合执行极早期的初始化操作。
ApplicationEnvironmentPreparedEvent
- 触发时机：环境对象（Environment）准备就绪，但上下文尚未创建。
- 用途：用于修改环境配置（如加载自定义属性文件）。
ApplicationPreparedEvent
- 触发时机：上下文刷新前（即 refresh() 方法调用前）。
- 用途：注册自定义 Bean 或修改上下文配置。
ContextRefreshedEvent
- 触发时机：Spring 容器初始化或刷新完成。
- 注意：若存在父子容器（如 Spring MVC），此事件会被触发多次。
ApplicationStartedEvent
- 触发时机：容器刷新完成后，但尚未调用 ApplicationRunner 或 CommandLineRunner。
- 用途：执行依赖容器的初始化逻辑。
ApplicationReadyEvent
- 触发时机：应用完全启动并准备好接收请求。
- 推荐场景：执行启动后初始化任务（如缓存预热）。
ApplicationFailedEvent
- 触发时机：启动过程中发生异常时。
- 用途：记录错误日志或触发告警。

2. 自定义事件

开发者可通过继承 ApplicationEvent 定义业务相关的事件。例如，当订单创建时发布 OrderCreateEvent，通知其他模块执行后续操作。

二、监听器的注册与触发顺序

Spring Boot 的监听器调用遵循严格的顺序，具体流程如下：

ApplicationStartingEvent → 2. ApplicationEnvironmentPreparedEvent →
ApplicationPreparedEvent → 4. ContextRefreshedEvent →
ApplicationStartedEvent → 6. ApplicationReadyEvent

注意：ContextRefreshedEvent 可能因父子容器被多次触发，而 ApplicationReadyEvent 仅触发一次，适用于单次初始化任务。

三、监听器的实现方式

1. 监听系统事件

方式一：实现 `ApplicationListener` 接口

java
@Component  
public class SystemStartupListener implements ApplicationListener<ApplicationReadyEvent> {  
    @Override  
    public void onApplicationEvent(ApplicationReadyEvent event) {  
        System.out.println("== 应用启动完成，执行缓存预热 ==");  
    }  
}

方式二：使用 `@EventListener` 注解

java
@Component  
public class AnnotationBasedListener {  
    @EventListener  
    public void handleStartedEvent(ApplicationStartedEvent event) {  
        System.out.println("== 捕获应用启动事件 ==");  
    }  
}

2. 自定义事件的发布与监听

步骤 1：定义事件类

java
public class OrderCreateEvent extends ApplicationEvent {  
    private String orderId;  
    public OrderCreateEvent(Object source, String orderId) {  
        super(source);  
        this.orderId = orderId;  
    }  
}

步骤 2：发布事件

java
@Service  
public class OrderService {  
    @Autowired  
    private ApplicationEventPublisher eventPublisher;  

    public void createOrder(Order order) {  
        // 创建订单逻辑...  
        eventPublisher.publishEvent(new OrderCreateEvent(this, order.getId()));  
    }  
}

步骤 3：监听事件

java
@Component  
public class OrderEventListener {  
    @EventListener  
    public void handleOrderEvent(OrderCreateEvent event) {  
        System.out.println("收到订单事件，ID：" + event.getOrderId());  
    }  
}

四、高级配置与技巧

1. 控制监听器执行顺序

通过 @Order 注解定义监听器的优先级：

java
@EventListener  
@Order(Ordered.HIGHEST_PRECEDENCE) // 最高优先级  
public void handleEventFirst(MyEvent event) {  
    // 优先执行的逻辑  
}

2. 异步处理事件

结合 @Async 实现非阻塞监听：

java
@Configuration  
@EnableAsync  
public class AsyncConfig { ... }  

@EventListener  
@Async  
public void asyncHandleEvent(MyEvent event) {  
    // 异步执行耗时操作  
}

3. 条件过滤事件

通过 SpEL 表达式筛选特定事件：

java
@EventListener(condition = "#event.orderId.startsWith('VIP')")  
public void handleVipOrder(OrderCreateEvent event) {  
    // 仅处理 VIP 订单  
}

五、常见问题与解决方案

ContextRefreshedEvent 被多次触发
- 原因：父子容器均会触发此事件。
- 解决方案：优先使用 ApplicationReadyEvent 保证逻辑仅执行一次。
监听器未生效
- 检查是否遗漏 @Component 或 @Service 注解。
- 确认事件发布逻辑是否正确调用 ApplicationEventPublisher。

六、总结与最佳实践

选择合适的事件类型：
- 启动后初始化任务 → ApplicationReadyEvent。
- 容器刷新逻辑 → ContextRefreshedEvent（注意重复触发问题）。
解耦业务逻辑：
通过自定义事件实现模块间通信，避免直接依赖。
性能优化：
对耗时操作使用异步监听（@Async），避免阻塞主线程。

通过合理使用监听器，开发者可以更优雅地管理应用生命周期，提升系统的可维护性与扩展性。

目录