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

SpringBoot自动配置原理总结

news 2025/8/27 15:27:00

1、我们需要从主启动类的@SpringBootApplication注解开始分析：

@SpringBootApplication是一个复合注解，进入以后看到主要包括以下三个注解：

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication{}

复制

2、这三个注解的功能如下：

@SpringBootConfiguration：底层还是一个@Configuration，代表当前是一个配置类。

@ComponentScan：指定组件扫描的类型和范围。

@EnableAutoConfiguration：开启自动配置，这个注解是自动配置的重点

3、进入@EnableAutoConfiguration可看到：

@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {}

复制

@AutoConfigurationPackage作用：自动配置包，指定类默认的包规则。具体来说就是利用Registrar将指定包（主启动类所在包）下的一系列组件导入到容器中。

@Import(AutoConfigurationPackages.Registrar.class)
public @interface AutoConfigurationPackage {}

复制

@Import(AutoConfigurationImportSelector.class)作用：

1、利用getAutoConfigurationEntry(annotationMetadata);给容器中批量导入一些组件 2、调用List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes)获取到所有需要导入到容器中的配置类 3、利用工厂加载 Map<String, List<String>> loadSpringFactories(@Nullable ClassLoader classLoader)；得到所有的组件 4、从META-INF/spring.factories位置来加载一个文件。默认扫描我们当前系统里面所有META-INF/spring.factories位置的文件。

重点就是扫描spring-boot-autoconfigure-2.3.4.RELEASE.jar包里面的META-INF/spring.factories，文件里面写死了spring-boot一启动就要给容器中加载的所有配置类，总共127个。（！！！注意：这个个数的话，不同的版本是不同的，spring-boot-autoconfigure-2.6.4.jar是133个！！！）

4、按需开启自动配置项

虽然这127个场景的所有自动配置在启动的时候默认全部加载。但不会全部生效。最终某一个xxxxAutoConfiguration会按照条件装配规则（@Conditional）进行生效，实现按需开启。

5、修改默认配置

springboot非常细心和人性化，为了防止有些用户的配置不符合规范，springboot会通过代码将其强制规范，如下面文件上传解析器的例子，若用户定义的上传解析器的名字不是multipartResolver，经过下面的代码后，会强制命名为multipartResolver：

@Bean
@ConditionalOnBean(MultipartResolver.class)  //容器中有这个类型组件
@ConditionalOnMissingBean(name = DispatcherServlet.MULTIPART_RESOLVER_BEAN_NAME) //容器中没有这个名字 multipartResolver 的组件
public MultipartResolver multipartResolver(MultipartResolver resolver) {//给@Bean标注的方法传入了对象参数，这个参数的值就会从容器中找。//SpringMVC multipartResolver。防止有些用户配置的文件上传解析器不符合规范// Detect if the user has created a MultipartResolver but named it incorrectlyreturn resolver;
}

复制