SpringBoot 自动配置原理（超级无敌详细）-1

关注

原创最新推荐文章于 2026-05-30 13:43:03 发布 3.3k 阅读 AI 写同款· GEO 优化 ›

SpringBoot 自动配置原理详解在加载自动配置类的时候，并不是将spring.factories的配置全部加载进来，而是通过@Conditional等注解的判断进行动态加载@Conditional其实是spring底层注解，意思就是根据不同的条件，来进行自己不同的条件判断，如果满足指定的条件，那么配置类里边的配置才会生效。常用的Conditional注解：@ConditionalOnClass ： classpath中存在该类时起效@ConditionalOnMissingClass ： classpath中不存在该类时起效。阅读详情

Spring Boot

```
@SpringBootApplication
```
- 该注解标注在某个类上，说明该类为 SpringBoot的主配置类，SpringBoot 就应该运行这个类的main()方法来启动SpringBoot的应用。
- 那**@SpringBootApplication** 是什么来的呢？点开它，我们能够发现，其实它是一个组合注解。又着两个重要的注解 @SpringBootConfiguration 和 @EnableAutoConfiguration
- 那接下来，我们就来分析这两个注解吧。

1.@SpringBootConfiguration

```
@SpringBootConfiguration
```
- 该注解标注在某个类上，说明该类为 SpringBoot的配置类，(注意 是配置类，没有主)
- 在该注解下还有一个 注解为 @Conguration ，即为配置类。因为SpringBoot中没有像Spring那样的大量的配置文件，所以为了让SpringBoot 知道哪些是配置类，所以就需要有@Configuration。当然了，@Configuration是Spring下的配置类注解，@SpringBootConfiguration是SpringBoot下的配置类注解，但二者的本质相同
- 当我们把 @Configuration 在点进去，我们能发现它的本质是一个组件。所以 配置类也是容器中的一个组件
- 加下来我们再看@SpringBootApplication的第二个注解**@EnableAutoConfiguration**

2.@EnableAutoConfiguration

@EnableAutoConfiguration 就是为SpringBoot实现自动配置的核心注解。它的意思就是开启自动配置功能。也就是说我们之前需要配置的东西，现在都不需要配置了 而在 @EnableAutoConfiguration 的内部又有两个非常重要的注解，分别为 @AutoConfigurationPackage 和 @Import(AutoConfigurationImportSelector.class) 。

1.@AutoConfigurationPackage 自动配置包

```
@AutoConfigurationPackag
```
- 我们进入 @AutoConfigurationPackag 的内部，我们发现这个该注解是由一个 @Import注解来完成的
- @Import(AutoConfigurationPackages.Registrar.class) 注解是Spring底层的一个注解，它的作用就是给容器中导入一个组件，也就是导入 AutoConfigurationPackages.Registrar.class 的组件，那我们也进入 Registrar 类的内部它是 AutoConfigurationPackages 下的一个静态内部类**。这个类（Registrar 类）的作用是给容器中导入组件**
- 我们主要看后面的 new PackageImport(metadata).getPackageName() ，它是导入一个 metadata（注解源信息）到PackageImport中，然后获取这个包的包名 。那重点是这个实例对象获取的包名是什么呢？
- 我们对这个 new PackageImport(metadata).getPackageName() 右键，找到该功能 new PackageImport(metadata).getPackageName()
  
  对它的值进行计算一下，得到返回得结果是
- 我们发现这个结果就是与我们 SpringBoot主配置类所在的包的包名
- 总结： @AutoConfigurationPackag 的作用就是将SpringBoot 主配置类所在的包及其下面的所有子包里面的所有组件扫描到 Spring 容器中

2.@Import(AutoConfigurationImportSelector.class)

```
@Import(AutoConfigurationImportSelector.class)
```
- 这一个注解的作用就是给容器中导入组件，这个注解需要导入的组件就是 AutoConfigurationImportSelector，也就是自动配置导入选择器，它可以帮我们选择需要导入的组件
- 进入AutoConfigurationImportSelector 查看源码，我们发现这与SpringBoot1.x版本有着一些区别，在SpringBoot2.x 中有一个静态内部类
  
  大致的意思是 自动配置组，能够帮我们完成一系列自动配置的操作。我们的重点回到该 静态内部类下的process()方法
  
  调用了getAutoConfigurationEntry()方法，该方法的作用就是告诉 Spring容器需要导入什么组件，并以 String[] 的形式返回全类名
  
  从configurations（标蓝的一行），我们可以看出 SpringBoot 已经帮我们自动导入了 124 个组件，从下图可以看出都是以全类名的形式返回。而且这些组件的名字都是以 ...AutoConfiguration 的形式命名，也就是什么自动配置类
  
  有了这些自动配置类，我们就免去了手动配置注入功能组件的操作了
- 那为什么他能做到自动配置呢？其实这也是有依据的。configurations 这个变量是由 getCandidateConfigurations() 方法得到的，也就是获取候选的配置。
- 这里调用了 SpringFactoriesLoader.loadFactoryNames(EnableAutoConfiguration.class，this.beanClassLoader) , 传入了两个参数
- 那我们就来看下 loadFactoryNames() 作用在这里又调用了loadSpringFactories(类加载器) 并将类加载器作为参数。
- 首先是在 133 行，从类加载器中加载一个资源，资源路径为FACTORIES_RESOURCE_LOCATION（即为）将获取到的一个资源赋值给 Enumeration类型的变量urls，如果该变量中有下一个元素，说明这里面又包含资源，那就将这个资源加载成 properties 配置文件，并转换成为键值对即 Map类型的数据 进行返回
- 那我们也来看看 META-INF/spring.factories资源路径下的内容长什么样
- 总结： SpringBoot 在启动的时候就从类路径下的 META-INF/spring.factories 中获取EnableAutoConfiguration指定的值，并将这些值加载到自动配置类导入到容器中，自动配置类就生效，帮助我们进行自动配置功能。而这些自动配置类全都在 spring-boot-autoconfigure-2.2.6.RELEASE.jar 该jar包之下
- 那我们现在就回到这个 META-INF/spring.factories 文件，我们找一个自动配置类作为示例，就例如最后的
```
org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration,\
```
  我们点进去这个自动配置类看看为了配置了什么功能（太多了，随便列举几个在SpringMVC常见的）
- 内部资源视图解析器（能够帮我们拼接视图的前后缀）