SOFABoot源码解析之启动原理（1）-注解分析

关注

原创最新推荐文章于 2026-09-08 19:07:30 发布 3.3k 阅读 AI 写同款· GEO 优化 ›

异步初始化bean 前两天在看 SOFABoot 的时候，看到一个让我眼前一亮的东西，来给大家盘一下。SOFABoot，你可能不眼熟，但是没关系，本文也不是给你讲这个东西的，你就认为它是 SpringBoot 的变种就行了。因为有蚂蚁金服背书，所以主要是一些金融类的公司在使用这个框架：官方介绍是这样的：SOFABoot 是蚂蚁金服开源的基于 Spring Boot 的研发框架，它在 Spring Boot 的基础上，提供了诸如 Readiness Check，类隔离，日志空间隔离等能力。阅读详情

一、概述

SOFABoot是蚂蚁金服开源的基于 Spring Boot 的研发框架，它在Spring Boot 的基础上，提供了诸如 Readiness Check，类隔离，日志空间隔离等等能力。在增强了 Spring Boot 的同时，SOFABoot 提供了让用户可以在 SpringBoot中非常方便地使用 SOFA 中间件的能力。

为了基于SOFABoot框架进行研发，建议大家熟读一下《SpringBoot参考指南》这本书。SpringBoot参考指南有html，pdf和epub等形式的文档，大家可以从http://docs.spring.io/spring-boot/docs/current/reference获取到最新版本。

在此，通过详细地描述SpringBoot内部启动原理，为大家基于SOFABoot框架进行开发提供快速入门。

由于SOFABoot基于SpringBoot项目，所以会用到SpringBoot的启动类：

1. @SpringBootApplication
2. @ImportResource({"classpath*:rpc-starter-example.xml" })
3. public class SofaBootRpcDemoApplication {
4.
5.     public static void main(String[] args)throws InterruptedException {
6.
7.         ApplicationContext applicationContext =SpringApplication.run(SofaBootRpcDemoApplication.class, args);
8.
9.     }
10. }

从@SpringBootApplication和SpringApplication.run开始，我们逐步分析SpringBoot的启动原理。

首先，看一下注解@SpringBootApplication的定义：

1. @Target(ElementType.TYPE)
2. @Retention(RetentionPolicy.RUNTIME)
3. @Documented
4. @Inherited
5. @SpringBootConfiguration
6. @EnableAutoConfiguration
7. @ComponentScan(excludeFilters =@Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class))
8. public @interface SpringBootApplication {
9. ……略
10. }

@SpringBootApplication是一个复合Annotation，使用了多个Annotation进行了原信息标注，其中3个比较关键的Annotation分别为：

1. @SpringBootConfiguration，实际使用@Configuration；

2. @EnableAutoConfiguration；

3. @ComponentScan；

二、@Configuration

@Configuration注解是JavaConfig形式的Spring Ioc容器的配置类，可替换Spring XML配置文件。

被@Configuration注解的配置类包含一个或多个被@Bean注解的方法，这些方法将会被AnnotationConfigApplicationContext或AnnotationConfigWebApplicationContext类进行扫描，并用于构建bean定义，初始化Spring容器。

@Configuration注解的配置类有如下要求：

1. @Configuration不可以是final类型；

2. @Configuration不可以是匿名类；

3. 嵌套的configuration必须是静态类。

代码示例如下：

1. @Configuration
2. public class TestConfiguration {
3.     public TestConfiguration() {
4.         System.out.println("TestConfiguration容器启动初始化。。。");
5.     }
6.
7.     // @Bean注解注册bean,同时可以指定初始化和销毁方法
8.     //@Bean(name="testBean",initMethod="start",destroyMethod="cleanUp")
9.     @Bean
10.     @Scope("prototype")
11.     public TestBean testBean() {
12.         return new TestBean();
13.     }
14. }

SpringBoot社区推荐使用基于JavaConfig的配置形式。所以，这里的启动类标注了@Configuration之后，本身其实也是一个IoC容器的配置类。

三、@ComponentScan

@ComponentScan注解对应Spring XML文件中的 <context:component-scan>元素。

@ComponentScan的功能是自动扫描并加载符合条件的组件（比如@Component和@Repository等）的bean定义，最终将这些bean定义加载到IoC容器中。

通过basePackages、basePackageClasses、includeFilters、excludeFilters等属性来细粒度的定制@ComponentScan自动扫描的范围，在此只描述比较常用的两个属性，其它属性自行查阅相关资料。

1. basePackages：扫描basePackages中指定的package及其子package中声明的组件。

2. basePackageClasses：扫描basePackageClasses中指定的类所在的package及其子package中声明的组件。

如果不指定，则默认Spring框架实现会从声明@ComponentScan所在类的package进行扫描。所以，SpringBoot的启动类最好是放在root package下，因为默认不指定basePackages。

四、@EnableAutoConfiguration

@EnableAutoConfiguration注解的自动配置功能是从classpath中搜寻所有的META-INF/spring.factories配置文件（项目及该项目依赖的Jar包），并将其中org.springframework.boot.autoconfigure.EnableAutoConfiguration对应的配置项通过反射机制实例化为对应的标注了@Configuration的JavaConfig形式的IoC容器配置类，然后加载到IoC容器。

@Enable*注释并不是新发明的注解，早在Spring 3框架就引入了这些注解，用这些注释替代XML配置文件。

很多Spring开发者都知道@EnableTransactionManagement注解，它能够声明事务管理；@EnableWebMvc注解，它能启用Spring MVC；@EnableScheduling注解，它可以初始化一个调度器；@EnableMBeanExport是通过@Import将JMX相关的bean定义加载到IoC容器。这些注解事实上都是简单的配置，通过@Import注解导入。

@EnableAutoConfiguration也是借助@Import的帮助，将所有符合自动配置条件的bean定义加载到IoC容器。

@EnableAutoConfiguration是一个复合Annotation，其自身定义关键信息如下：

1. @Target(ElementType.TYPE)
2. @Retention(RetentionPolicy.RUNTIME)
3. @Documented
4. @Inherited
5. @AutoConfigurationPackage
6. @Import(EnableAutoConfigurationImportSelector.class)
7. public @interface EnableAutoConfiguration{
8. ……略
9. }

其中，最关键部分为@Import(EnableAutoConfigurationImportSelector.class)。借助EnableAutoConfigurationImportSelector功能，@EnableAutoConfiguration可以帮助SpringBoot应用将所有符合条件的@Configuration配置都加载到当前SpringBoot创建并使用的IoC容器。

EnableAutoConfigurationImportSelector类使用SpringFactoriesLoader类的loadFactoryNamesof()方法，而SpringFactoriesLoader会查询所有加载的Jar包中的META-INF/spring.factories文件。

SpringFactoriesLoader属于Spring框架私有的一种扩展方案，其主要功能就是从指定的配置文件META-INF/spring.factories加载配置。借助于SpringFactoriesLoader的支持，@EnableAutoConfiguration可以实现智能的自动配置功能。

当找到spring.factories文件后，SpringFactoriesLoader以@EnableAutoConfiguration类的全限定类名org.springframework.boot.autoconfigure.EnableAutoConfiguration作为查找的Key,获取对应的一组@Configuration类。

让我们来看看spring-boot-autoconfigure模块的Jar包，它包含了一个spring.factories文件，内容如下：