Spring Boot 主程序入口与启动流程深度解析：从 @SpringBootApplication 到应用就绪

• 启用组件扫描，查找并注册带有 @Component、@Service、@Controller 等注解的 Bean。
• 默认扫描主类所在包及其子包下的所有组件。
• 可通过 basePackages 属性自定义扫描路径。

✅ 最佳实践：主类应放在根包下，确保所有业务组件被正确扫描。

2. SpringApplication.run() 启动流程详解

SpringApplication.run() 是整个启动过程的驱动引擎。其执行流程可分为多个阶段，下面我们结合源码逻辑进行拆解。

阶段 1：创建 SpringApplication 实例

public static ConfigurableApplicationContext run(Class<?> primarySource, String... args) {
    return new SpringApplication(primarySource).run(args);
}

在构造函数中完成以下初始化工作：

关键点：webApplicationType 的推断基于类路径中是否存在 Servlet API 和响应式框架。

阶段 2：运行 run() 方法（核心流程）

run() 方法是启动的主干，包含以下关键步骤：

步骤 ①：准备环境（prepareEnvironment()）

• 创建并配置 Environment 对象（StandardServletEnvironment）
• 加载外部配置：
  • application.properties/yml
  • 命令行参数（--server.port=8081）
  • 系统属性、环境变量
  • 配置中心（如 Nacos、Consul）
• 触发 ApplicationEnvironmentPreparedEvent 事件

💡 开发者可通过实现 EnvironmentPostProcessor 自定义环境处理逻辑。

步骤 ②：创建应用上下文（createApplicationContext()）

根据 webApplicationType 创建对应的 ApplicationContext：

该上下文负责管理 Bean 生命周期、资源加载、事件发布等。

步骤 ③：准备上下文（prepareContext()）

此阶段为上下文注入关键组件：

• 设置 Environment
• 执行 ApplicationContextInitializer（初始化器）
• 注册 ApplicationRunner 和 CommandLineRunner Bean
• 将主配置类注册为 Bean（load(context, sources)）
• 触发 ApplicationContextInitializedEvent

📌 ApplicationContextInitializer 示例：
通过 spring.factories 注册：

步骤 ④：刷新上下文（refreshContext()）

调用 AbstractApplicationContext.refresh()，这是 Spring 框架的核心方法，执行：

• BeanFactory 初始化
• Bean 定义加载与注册
• @PostConstruct 回调
• 自动配置类生效（@EnableAutoConfiguration 生效）
• 嵌入式 Web 容器启动（Tomcat/Jetty/Undertow）
• SmartLifecycle Bean 启动

⚠️ 若在此阶段发生异常（如端口占用），容器将关闭。

步骤 ⑤：完成刷新（afterRefresh()）

• 调用所有 ApplicationRunner 和 CommandLineRunner 的 run() 方法
• 这些 Runner 通常用于执行启动后任务（如数据预热、缓存加载）

步骤 ⑥：发布启动完成事件

• 触发 ApplicationReadyEvent
• 表示应用已完全启动，可以接收外部请求
• 监听此事件可执行'服务上线'通知等操作

步骤 ⑦：异常处理与退出钩子

• 使用 try-catch-finally 包裹，确保异常时能清理资源
• 注册 JVM 关闭钩子（Shutdown Hook），支持优雅停机（需配置 server.shutdown=graceful）

3. 启动流程图解

+---------------------+
| main() 方法         |
+----------+----------+
           v
+------------------------------+
| 创建 SpringApplication 实例  |
| - 推断 Web 类型              |
| - 加载 Initializers/Listeners|
+--------------+---------------+
               v
+----------------------------------+
| run() 方法                       |
+----------------------------------+
+-------------------------+--------------------------+
|                         |                          |
v                         v                          v
+------------------+ +----------------------+ +------------------------+
| prepareEnvironment | | createApplicationContext | | prepareContext       |
| - 加载配置源       | | - 创建上下文实例     | | - 设置 Environment   |
| - 发布事件         | |                      | | - 执行 Initializer   |
+------------------+ +----------------------+ | - 注册主配置类       |
                                               +------------------------+
                                                           v
                                                +----------------------------+
                                                | refreshContext()           |
                                                | - BeanFactory 初始化       |
                                                | - 自动配置生效             |
                                                | - 启动 Web 容器            |
                                                +-------------+--------------+
                                                              v
                                                +-------------------------------+
                                                | afterRefresh()                |
                                                | - 执行 ApplicationRunner      |
                                                | - 执行 CommandLineRunner      |
                                                +---------------+----------------+
                                                                v
                                                +----------------------------------+
                                                | 发布 ApplicationReadyEvent       |
                                                | 启动完成，等待请求               |
                                                +----------------------------------+

4. 扩展点与高级用法

Spring Boot 提供了丰富的扩展机制，允许开发者干预启动过程。

4.1 ApplicationRunner vs CommandLineRunner

@Component
@Order(1)
public class StartupTask implements ApplicationRunner {
    @Override
    public void run(ApplicationArguments args) throws Exception {
        if (args.containsOption("init-db")) {
            // 执行数据库初始化
        }
    }
}

@Order 控制执行顺序。

4.2 自定义 ApplicationListener

监听启动过程中的关键事件：

@Component
public class MyAppListener implements ApplicationListener<ApplicationEvent> {
    @Override
    public void onApplicationEvent(ApplicationEvent event) {
        if (event instanceof ApplicationReadyEvent) {
            System.out.println("应用已就绪，可以开始处理请求");
        }
    }
}

常用事件：

• ApplicationStartingEvent
• ApplicationEnvironmentPreparedEvent
• ApplicationContextInitializedEvent
• ApplicationPreparedEvent
• ApplicationReadyEvent
• ApplicationFailedEvent

4.3 优雅停机（Graceful Shutdown）

配置 application.yml：

server:
  shutdown: graceful
spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s

实现 SmartLifecycle 或使用 @PreDestroy 处理清理逻辑。

5. 常见问题与排查建议

6. 总结

Spring Boot 的启动流程是一个高度模块化、可扩展的设计典范。它通过 自动配置、事件驱动 和 约定优于配置 的理念，将复杂的 Spring 应用初始化过程封装得简洁而强大。

理解这一流程，不仅能帮助你写出更规范的启动类，还能在面对启动异常、性能瓶颈等问题时，快速定位根源，提升系统稳定性与可维护性。