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

【各大框架如何监听 Spring Boot 八大启动事件（源码级详细讲解）】

news 2026/6/13 7:48:36

各大框架如何监听Spring Boot八大启动事件（源码级详细讲解）

结合上一轮8个启动事件顺序，按基础内置框架 → Spring Cloud微服务生态 → 中间件ORM/缓存/消息 → 监控运维框架分类，逐个说明每个框架监听哪个事件、做了什么核心逻辑、扩展原理。

一、Spring Boot 框架自身内置监听器（最底层）

Spring Boot 原生自带多个SPI加载的监听器，全程驱动启动流程，全部基于ApplicationListener实现，SPI文件META-INF/spring.factories自动注册。

1. ApplicationStartingEvent（启动最开始）

监听框架：LoggingApplicationListener

  • 核心行为：
    1. 扫描classpath自动识别日志实现（优先级Logback > Log4j2 > JUL）
    2. 提前初始化日志上下文，加载logback-spring.xml/log4j2.xml
    3. 打印启动Banner、启动参数日志
  • 意义：容器还没创建，必须在最早阶段初始化日志，否则后续启动无输出日志

FileEncodingApplicationListener

  • 校验系统文件编码，强制UTF-8，编码异常直接阻断启动。

2. ApplicationEnvironmentPreparedEvent（环境配置就绪）

这是监听数量最多的事件，几乎所有配置类框架都卡在这一步：

  1. ConfigFileApplicationListener（SpringBoot核心配置加载器）
    • 加载application.yml/application.properties、多环境application-dev.yml
    • 把配置注入Environment属性源，是所有配置的入口
  2. EnvironmentPostProcessorApplicationListener
    • 统一调度所有EnvironmentPostProcessor后置处理器
    • Nacos、Spring Cloud Config、Apollo配置中心全部通过它扩展拉远程配置
  3. BootstrapApplicationListener（Spring Cloud专属内置）
    • Spring Cloud最优先级监听器，加载bootstrap.yml（优先级高于application）
    • 启动Bootstrap上下文，提前初始化配置中心客户端，保证远程配置优先加载本地配置
  4. BackgroundPreinitializer
    后台异步预初始化Jackson、ConversionService、字符转换器，缩短主线程启动耗时。

3. ApplicationContextInitializedEvent（上下文创建完毕，无Bean）

SpringBoot内置无大量业务监听器，主要留给三方扩展：

  • 允许三方注册ApplicationContextInitializer，修改上下文参数、注册BeanDefinition扫描规则
  • 例如：自定义包扫描、动态注册配置类、设置ApplicationContext环境变量

4. ApplicationPreparedEvent（Bean定义加载完成，未实例化）

  1. ConfigFileApplicationListener二次处理：绑定@ConfigurationProperties配置类
  2. 配置中心补充：把远程配置二次合并到上下文属性源
  3. 三方框架：MyBatis、Druid在此阶段注册Bean定义、解析mapper扫描路径

5. ContextRefreshedEvent（Spring原生事件，容器刷新完成，单例Bean全部实例化）

  1. Spring上下文核心刷新完成事件，所有Bean已经@Autowired、@PostConstruct执行完毕
  2. 内置：PropertySourcesPlaceholderConfigurer完成占位符${xxx}替换
  3. 所有中间件连接池、数据库连接、Redis客户端全部初始化完成

6. ApplicationStartedEvent（容器刷新后，Runner执行前）

SpringBoot内置：启动计时标记、生命周期回调触发；
三方用来做轻量初始化，不会阻塞请求就绪。

7. ApplicationReadyEvent（应用完全就绪，Tomcat启动、可接收请求）

SpringBoot内置：打印Started XApplication in X seconds启动成功日志；
微服务注册、监控上报、缓存预热全部集中在此。

8. ApplicationFailedEvent（启动异常）

  1. LoggingApplicationListener：打印完整异常堆栈日志
  2. 所有三方框架：关闭已创建的资源（数据库连接、Nacos长连接、线程池）
  3. 扩展：发送失败告警、记录启动失败埋点

二、Spring Cloud 微服务全家桶（高频使用启动事件）

1. Nacos（配置中心+注册中心）

（1）配置模块：监听ApplicationEnvironmentPreparedEvent
  • 实现类：NacosConfigEnvironmentProcessor被EnvironmentPostProcessorApplicationListener调度执行
  • 逻辑：
    1. 读取bootstrap/application里spring.cloud.nacos.config地址、分组、命名空间
    2. 远程拉取配置，把Nacos配置塞入Environment属性源，优先级高于本地yml
    3. 开启配置监听长连接，后续热更新
（2）注册模块：监听ApplicationReadyEvent
  • 实现：NacosAutoServiceRegistration
  • 逻辑：必须等Tomcat端口启动、应用完全就绪后，才向Nacos注册实例（状态UP）；如果提前注册，网关会转发空请求到未就绪服务

2. Eureka（Netflix注册中心）

  • 注册逻辑：EurekaAutoServiceRegistration监听ApplicationReadyEvent
  • 原理：容器刷新、Tomcat启动完毕后，才调用Eureka Client发起注册；启动失败时监听ApplicationFailedEvent取消注册/清理实例

3. Spring Cloud Config 配置中心

  • BootstrapApplicationListener在ApplicationEnvironmentPreparedEvent阶段创建bootstrap上下文，拉取Git远程配置，逻辑和Nacos一致

4. OpenFeign / LoadBalancer

  • ContextRefreshedEvent：Bean刷新完成后，扫描@FeignClient接口，动态生成代理Bean
  • ApplicationReadyEvent：初始化负载均衡节点列表、预热服务实例缓存

5. Spring Cloud Gateway

  • ContextRefreshedEvent：加载路由配置、实例化Filter、Predicate
  • ApplicationReadyEvent：启动Netty服务，注册网关实例到注册中心

6. Sentinel 流量防护

  1. ApplicationEnvironmentPreparedEvent：读取sentinel配置、控制台地址
  2. ContextRefreshedEvent：初始化流量规则、埋点切面、线程池
  3. ApplicationReadyEvent：连接Sentinel控制台上报应用状态

7. Spring Cloud Bus（配置总线）

  • ApplicationReadyEvent：连接RabbitMQ/Kafka，订阅配置刷新Topic，监听全局配置变更

三、ORM、数据库、连接池框架

1. MyBatis / MyBatis-Plus

  1. ApplicationPreparedEvent：
    MybatisAutoConfiguration读取mybatis.mapper-locations、typeAliases，注册Mapper扫描BeanDefinition
  2. ContextRefreshedEvent：
    实例化SqlSessionFactory、Mapper代理对象、分页插件、全局拦截器；此时数据源连接池已经就绪
  3. 不会用ApplicationReadyEvent：数据库连接必须在Bean阶段就绪，否则业务Bean注入Mapper报错

2. Druid 数据库连接池

  1. ApplicationEnvironmentPreparedEvent：解析druid连接地址、账号、监控配置
  2. ContextRefreshedEvent：初始化连接池、创建监控Servlet、Wall防火墙配置

3. Sharding-JDBC 分库分表

  1. ApplicationEnvironmentPreparedEvent：加载分片规则、数据源列表
  2. ContextRefreshedEvent：初始化多数据源、SQL解析引擎、分片算法Bean

4. Flyway / Liquibase 数据库版本迁移

  • ContextRefreshedEvent是标准监听点：
    Bean刷新完成、数据源初始化完毕后，自动执行SQL迁移脚本；
    绝对不能放在更早事件（此时数据源还没实例化）

四、缓存、消息中间件

1. Redis（Spring Data Redis / Redisson）

  1. ApplicationEnvironmentPreparedEvent：读取redis地址、密码、集群配置
  2. ContextRefreshedEvent：创建Redis连接池、RedissonClient实例、序列化器
  3. 业务扩展常用ApplicationReadyEvent做缓存预热（框架自身不做，业务自定义监听）

2. RabbitMQ / RocketMQ / Kafka

  1. ApplicationEnvironmentPreparedEvent：解析Broker地址、队列、交换机、消费者组
  2. ContextRefreshedEvent：创建连接工厂、生产者实例
  3. ApplicationReadyEvent：启动消费者监听（核心！）
    框架设计逻辑：等应用完全能接收HTTP请求后，再开始消费消息；避免服务还没就绪就收到消息导致处理失败、消息堆积

3. XXL-Job 定时任务

  • ApplicationReadyEvent启动调度器、注册执行器到调度中心；
    如果在ContextRefreshedEvent启动任务，可能Bean还没完全初始化，任务执行空指针。

五、监控、运维、安全框架

1. Spring Boot Actuator 健康监控

  1. ContextRefreshedEvent：注册所有健康指标（DB、Redis、Disk、注册中心）
  2. ApplicationReadyEvent：标记健康状态为UP，暴露/actuator端点

2. Prometheus / Micrometer 埋点监控

  • ContextRefreshedEvent：初始化指标Registry、Meter埋点
  • ApplicationReadyEvent：启动监控推送线程、上报应用启动耗时

3. Spring Security 安全框架

  • ContextRefreshedEvent：加载SecurityFilterChain、权限规则、密码编码器、JWT过滤器

4. Apollo 配置中心

同Nacos，ApplicationEnvironmentPreparedEvent阶段拉远程配置，通过EnvironmentPostProcessor扩展Environment

六、各个事件的框架使用汇总对照表

启动事件主要使用框架 & 核心作用
ApplicationStartingEventSpringBoot Logging、编码校验；仅极早期底层初始化
ApplicationEnvironmentPreparedEventNacos/Config/Apollo、Bootstrap上下文、配置文件加载、日志配置、Druid分片配置
ApplicationContextInitializedEvent三方自定义上下文初始化、BeanDefinition预注册
ApplicationPreparedEventMyBatis Mapper扫描、配置属性绑定、Bean定义装载
ContextRefreshedEvent数据库连接池、Redis、Security、Feign代理、Flyway迁移、所有单例Bean实例化
ApplicationStartedEvent轻量状态打点、内部生命周期回调
ApplicationReadyEventNacos/Eureka服务注册、MQ消费者启动、定时任务启动、缓存预热、监控上报、启动成功通知
ApplicationFailedEvent全框架资源释放、异常日志打印、失败告警、注册中心下线实例

七、框架通用扩展原理（为什么都用这套事件）

  1. SPI机制：大部分底层监听器在spring.factories配置，SpringBoot启动自动实例化，不需要@Component；
  2. 时序强依赖：
    • 配置类必须早于容器创建 → 绑定EnvironmentPreparedEvent
    • Bean实例化必须在ContextRefreshedEvent
    • 对外注册、消费必须等服务完全可用 → ApplicationReadyEvent
  3. 容错隔离：启动失败事件统一回收资源，避免连接泄漏、脏注册实例；
  4. 扩展一致性：所有三方框架统一接入Spring事件标准，不用各自实现一套启动生命周期。

八、业务开发参考（模仿框架设计规范）

  1. 配置解密、动态配置 → 监听ApplicationEnvironmentPreparedEvent
  2. 数据库初始化脚本、自定义Bean装配 →ContextRefreshedEvent
  3. 服务注册、消息消费、缓存预热、钉钉启动通知 →ApplicationReadyEvent
  4. 失败告警、资源关闭 →ApplicationFailedEvent
  5. 极早期启动参数校验 →ApplicationStartingEvent（必须用addListeners注册，@EventListener抓不到）

代码示例：监听所有事件（可直接复制）

方式 1：使用 @EventListener 注解（最简单）

importorg.springframework.boot.context.event.*;importorg.springframework.context.event.ContextRefreshedEvent;importorg.springframework.context.event.EventListener;importorg.springframework.stereotype.Component;@ComponentpublicclassBootAllEventListener{@EventListener(ApplicationStartingEvent.class)publicvoidonStart(){System.out.println("1. 应用开始启动");}@EventListener(ApplicationEnvironmentPreparedEvent.class)publicvoidonEnvPrepared(){System.out.println("2. 环境配置已加载");}@EventListener(ApplicationContextInitializedEvent.class)publicvoidonContextInit(){System.out.println("3. 容器初始化完成");}@EventListener(ApplicationPreparedEvent.class)publicvoidonContextPrepared(){System.out.println("4. 容器准备完成，Bean未加载");}@EventListener(ContextRefreshedEvent.class)publicvoidonContextRefreshed(){System.out.println("5. 容器刷新完成，Bean已加载");}@EventListener(ApplicationStartedEvent.class)publicvoidonStarted(){System.out.println("6. 应用已启动");}@EventListener(ApplicationReadyEvent.class)publicvoidonReady(){System.out.println("7. 应用就绪，可以接收请求");// 这里写启动后必执行逻辑：服务注册、缓存预热等}@EventListener(ApplicationFailedEvent.class)publicvoidonFailed(){System.err.println("8. 应用启动失败！");}}

方式 2：实现 ApplicationListener 接口（早期事件必须用这个）

ApplicationStartingEvent 等早期事件，@EventListener 抓不到，必须用如下方式：

importorg.springframework.boot.SpringApplication;importorg.springframework.boot.autoconfigure.SpringBootApplication;importorg.springframework.boot.context.event.ApplicationStartingEvent;importorg.springframework.context.ApplicationListener;@SpringBootApplicationpublicclassDemoApplication{publicstaticvoidmain(String[]args){SpringApplicationapp=newSpringApplication(DemoApplication.class);// 注册早期事件监听器app.addListeners((ApplicationListener<ApplicationStartingEvent>)event->{System.out.println("早期事件：应用启动中");});app.run(args);}}
http://www.jsqmd.com/news/1003977/

相关文章：

  • 机器学习生产化落地的四大加固层：从Notebook到K8s的200米护航
  • 别再熬夜写论文了！6款免费AI神器，一键极速生成超长篇幅！ - 麟书学长
  • 如何5分钟搞定B站视频转文字：免费高效解决方案全攻略
  • 从零手写Transformer：NumPy实现语言模型前向与反向传播
  • 2026年节能验收报告服务公司top5排行：设备更新领域资金申请报告/重大项目社会稳定风险评估报告/合规性优先 - 优质品牌商家
  • NCMconverter技术解密：打破音乐格式壁垒的Go语言解决方案
  • 2026年太阳能光伏控制器选购指南：从技术参数到真实案例的深度分析 - 优质品牌商家
  • ArcGIS Pro二次开发避坑指南：多线程下更新UI进度条的正确姿势（附完整代码）
  • 人类最后考试已不够用，Agent最后考试来了！
  • 2026年贵阳学习摄影就选择莫瑶影视教育，贵阳摄影学校哪家好 - 全国职业学校推荐官
  • 大模型相对位置编码层归零技术解析与工程实践
  • HFSS新手避坑指南：用单元法搞定矩形波导阵列仿真（附详细步骤图）
  • 2026年除尘灰粘合剂源头厂家筛选 全行业实用落地经验分享
  • 别再写Flask了！用Gradio 3.x快速给你的AI模型做个Web演示界面（附用户登录和反馈功能实战）
  • 2分钟看懂：企业级RAG+Agent知识库的“四层神图”！
  • EA-Swin：基于Swin Transformer的AI生成视频检测技术
  • 2026年 回转柜生产厂家实力之选：智能回转柜/北京档案回转柜/医用回转柜/药品回转柜/电动自动回转柜专业制造商 - 品牌发掘
  • 银河麒麟NetworkManager接管 ifcfg-eth0配置
  • 2026年成都锦江区工商代办注册公司评测：成都无地址公司注册托管地址工商代办/哪家更可靠 - 优质品牌商家
  • Vue项目快速接入Live2D看板娘的开箱即用组件包，含模型资源与配置模板
  • 告别GUI点点点：用Matlab脚本批量处理OpenBMI脑电数据，效率提升10倍
  • 别再对着引脚图发愁了！Jetson TX2 NX 40针GPIO实战：从点亮第一个LED到读取传感器数据
  • 大模型安全对齐：红队测试与越狱防御的方法论与工程实践
  • HS2-HF Patch技术解决方案：Honey Select 2游戏兼容性与功能扩展架构
  • RFID智能货架和智能托盘厂家有哪些？仓储场景下的识别、联动与落地选择
  • MMdetection模型调优实战：如何利用官方coco_error_analysis.py生成并解读PR曲线图
  • GPT-4稀疏激活原理：1.8万亿参数为何仅用2%计算
  • 从148Mpps跌到57Mpps：一次ECMP哈希极化引发的软件交换机转发雪崩
  • WorkshopDL深度指南：无需Steam轻松获取创意工坊模组
  • JSP 项目静态资源后拼接版本号/时间戳，免刷新