一文搞懂！SpringBoot自动装配原理

最新推荐文章于 2025-07-11 00:43:13 发布
原创 最新推荐文章于 2025-07-11 00:43:13 发布 · 2.8k 阅读 · 24 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring boot #后端 #java

一、前言

当我们开始使用Spring Boot时，我们会发现只需引入一个web相关的starter依赖，并进行一些简单配置，有的时候甚至可以不用配置（约定大于配置），应用就可以跑起来！这与Spring MVC相比，后者需要我们进行大量的手动配置和解决依赖冲突，显得繁琐复杂。Spring Boot是如何解决这一点，让我们能够更加专注于业务逻辑的开发呢？这得益于Spring Boot的核心特性——自动装配 。

学习参考视频：SpringBoot3
参考资料：SpringBoot3自动装配原理

二、自动装配是什么

Spring Boot的自动装配实际上是从META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中获取到对应的需要进行自动装配的类，并生成相应的Bean对象，然后将它们交给Spring容器进行管理

三、源码解析

这里我从项目的开始一步步带领大家深入分析自动装配的原理

1.导入starter场景

我们这里以spring-boot-starter-web为例

在这里插入图片描述
当导入starter-web场景启动器后，我们就导入了和Web相关场景的所有依赖：starter-tomcat、starter-json、starter-tomcat、spring-webmvc、spring-boot-starter

其中spring-boot-starter是核心场景启动器，是所有starter的starter，基础核心starter（每个场景启动器都会引入一个核心场景启动器）
在这里插入图片描述
在核心场景启动器spring-boot-starter中又引入了spring-boot-autoconfigure包，这个包里面囊括了SpringBoot官方全场景的所有配置
在这里插入图片描述
只要spring-boot-autoconfigure这个包下的所有类都能生效，那么相当于SpringBoot官方写好的整合功能就生效了，但是SpringBoot默认却扫描不到 spring-boot-autoconfigure下写好的配置类。（SpringBoot默认只扫描主程序所在的包及其子包）

思考：官方写好的配置类默认却扫描不到，那该怎么让它生效呢？
跟随我的脚步，进行深入分析主程序：@SpringBootApplication，相信你会找到答案！

2.深入剖析启动类

SpringBoot的启动类是一切的开始，我可以发现在main方法上有个注解@SpringBootApplication
在这里插入图片描述
在这里插入图片描述

@SpringBootApplication是一个复合注解，由以下三个注解组合而成，@SpringBootConfiguration 、@EnableAutoConfiguration、@ComponentScan
在这里插入图片描述

  • @SpringBootConfiguration ：标记当前类为SpringBoot配置类
  • @EnableAutoConfiguration：开启自动配置的核心注解
  • @ComponentScan ：组件扫描

注意：上图我在三个注解前标注的序号，这是主程序运行起来后的执行顺序
下面我将逐一分析这个3个注解

@SpringBootConfiguration

@SpringBootConfiguration就是@Configuration的一个衍生注解
主要作用：标记该类为SpringBoot的配置类，并交给SpringIOC容器管理
在这里插入图片描述

@EnableAutoConfiguration

@EnableAutoConfiguration，顾名思义就是：开启自动配置，也是一个复合注解，由@AutoConfigurationPackage、@Import(AutoConfigurationImportSelector.class)组合而成
在这里插入图片描述

@AutoConfigurationPackage

@AutoConfigurationPackage主要作用：扫描主程序包，加载自己的组件

@Import：导入第三方的组件，可以导入三种类型的类

  1. 导入@Configuration注解的配置类：容器中就会自动注册这个组件，ID默认为全类名
  2. 导入ImportSelector 实现类：通过实现ImportSelector 类，实现selectImports方法，返回需要导入组件的全类名数组
  3. 导入ImportBeanDefinitionRegistrar实现类：通过实现中 ImportBeanDefinitionRegistrar类，实现registerBeanDefinitions 方法手动注册Bean到容器中
    详细内容可见@Import注解 -【Spring底层原理】Spring中Import注解源码解析

在这里插入图片描述
在这个注解利用 @Import(AutoConfigurationPackages.Registrar.class)把主程序所在包及其子包的所有组件导入进来

利用@Import ，在springboot中为给容器导入一个组件，而导入的组件由 AutoConfigurationPackages.class的内部类Registrar.class 执行逻辑来决定是如何导入的

进入到AutoConfigurationPackages类中找到内部类Registrar，并在图中位置打上断点
在这里插入图片描述

ImportBeanDefinitionRegistrar 接口：

  • 这个接口是 Spring 框架提供的，用于在配置类中动态注册 Bean 定义
  • 实现了这个接口的类可以通过 @Import 注解导入到 Spring 容器中

接下来我们利用小工具，来看看new PackageImports(metadata).getPackageNames()的值
在这里插入图片描述在这里插入图片描述
运行后我们可以看到new PackageImports(metadata).getPackageNames()的值为：com.weyang当前启动类所在的包名，
即把主程序所在的包的所有组件导入进来。

结论：@AutoConfigurationPackage就是将主配置类（@SpringBootApplication标记的类）所在包及其子包中的所有组件都扫描注册到Spring容器中

@Import(AutoConfigurationImportSelector.class)

AutoConfigurationImportSelector开启自动配置类的导包的选择器，确定哪些自动配置类应该被加载到 Spring 容器中。具体来说，它实现了 DeferredImportSelector 接口。
在这里插入图片描述

DeferredImportSelector 和 ImportSelector 的区别
在这里插入图片描述在这里插入图片描述
详细介绍：Spring中DeferredImportSelector源码解析
补充说明
在这里插入图片描述
由于AutoConfigurationImportSelector没有直接实现ImportSelector接口，而是实现的DeferredImportSelector接口，SpringBoot对于DeferredImportSelector接口的实现类有另外一组处理流程，因此在自动装配的流程中并不会去调用selectImports()方法

在这里插入图片描述

getImportGroup方法：根据这个方法得到具体的 Group 实现类

我们先在AutoConfigurationImportSelector中找到getImportGroup方法，通过这个方法可以知道DeferredImportSelector实现类对应的Group类AutoConfigurationGroup类
在这里插入图片描述
调用Group实现类AutoConfigurationGroup中的，process方法，并调用AutoConfigurationImportSelector的getAutoConfigurationEntry方法，获取所有的自动配置类
在这里插入图片描述

getAutoConfigurationEntry方法：获取所有的自动配置类

在这里插入图片描述
根据导入的 @Configuration 类的 AnnotationMetadata 返回一个 AutoConfigurationImportSelector.AutoConfigurationEntry 对象。这个对象包含了应该被导入的自动配置类列表以及被排除的配置类列表。
在 getCandidateConfigurations(annotationMetadata, attributes)这里打断点查看，可以看到configurations数组长度为181，并且文件后缀名都为 ***AutoConfiguration
在这里插入图片描述
进入getCandidateConfigurations(annotationMetadata, attributes)看看这个181个配置类从哪里来的
在这里插入图片描述
通过ImportCandidates.load(AutoConfiguration.class, getBeanClassLoader())方法，从类路径中加载所有标记了 @AutoConfiguration 注解的类，并返回这些类的全限定名列表，同时通过 Assert.notEmpty 方法确保列表不为空，否则抛出异常并提示检查配置文件

Assert.notEmpty(configurations,
				"No auto configuration classes found in "
						+ "META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports. If you "
						+ "are using a custom packaging, make sure that file is correct.");

意思是：在“META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports中没有找到自动配置类。如果您使用自定义包装，请确保该文件是正确的。” ------ 在2.7.0版本之前存放的地址是META-INF/spring.factories
我们点击进入load方法，就可以看到配置类存放地址是如何来的了！
在这里插入图片描述
我们可以看到扫描SPI文件地址：META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
然后调用findUrlsInClasspath方法在类路径中查找指定路径的资源，遍历找到的资源 URL，调用 readCandidateConfigurations 方法读取每个资源文件中的候选类名，并添加到 importCandidates 列表中。

注意：这里会加载所有jar包下的classpath路径下META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，这样的文件不止一个

现在我们进行回到AutoConfigurationImportSelector的getAutoConfigurationEntry方法
在这里插入图片描述
经过removeDuplicates方法去除重复的配置类，getExclusions方法去除手动排除的类，getConfigurationClassFilter方法根据条件判断，过滤掉不符合条件的配置类后，在我的这个项目中实际就剩下自动配置类数量为70个。
在这里插入图片描述

SPI机制：
● Java中的SPI（Service Provider Interface）是一种软件设计模式，用于在应用程序中动态地发现和加载组件。SPI的思想
是，定义一个接口或抽象类，然后通过在classpath中定义实现该接口的类来实现对组件的动态发现和加载。
● SPI的主要目的是解决在应用程序中使用可插拔组件的问题。例如，一个应用程序可能需要使用不同的日志框架或数据库> > 连接池，但是这些组件的选择可能取决于运行时的条件。通过使用SPI，应用程序可以在运行时发现并加载适当的组件，而> > 无需在代码中硬编码这些组件的实现类。
● 在Java中，SPI的实现方式是通过在META-INF/services目录下创建一个以服务接口全限定名为名字的文件，文件中包含实> 现该服务接口的类的全限定名。当应用程序启动时，Java的SPI机制会自动扫描classpath中的这些文件，并根据文件中指定> 的类名来加载实现类。
● 通过使用SPI，应用程序可以实现更灵活、可扩展的架构，同时也可以避免硬编码依赖关系和增加代码的可维护性。

在这里插入图片描述
根据刚刚找到的地址找到配置文件，我们可以看到在这个位置存的内容，就是SpringBoot启动默认加载的152个自动配置类xxxAutoConfiguration，因为演示的项目中还引入了其他的依赖，例如druid、mybatisplus等，所以刚刚显示的是181。
虽然SpringBoot默认导入了152个自动配置类， 并不是这152个自动配置类都能生效，每一个自动配置类，都有条件注解@ConditionalOnxxx，只有条件成立，才能生效

常用的@ConditionalOnXxx注解：

@ConditionalOnClass ： classpath中存在该类时起效
@ConditionalOnMissingClass ： classpath中不存在该类时起效
@ConditionalOnBean ： DI容器中存在该类型Bean时起效
@ConditionalOnMissingBean ： DI容器中不存在该类型Bean时起效
@ConditionalOnSingleCandidate ： DI容器中该类型Bean只有一个或@Primary的只有一个时起效
@ConditionalOnExpression ： SpEL表达式结果为true时
@ConditionalOnProperty ： 参数设置或者值一致时起效
@ConditionalOnResource ： 指定的文件存在时起效
@ConditionalOnJndi ： 指定的JNDI存在时起效
@ConditionalOnJava ： 指定的Java版本存在时起效
@ConditionalOnWebApplication ： Web应用环境下起效
@ConditionalOnNotWebApplication ： 非Web应用环境下起效

@ConditionalOnXxx其实是spring底层注解，意思就是根据不同的条件，来进行自己不同的条件判断，如果满足指定的条件，那么配置类里边的配置才会生效。

在152个自动配置类的全类名中，我们找到Spring MVC 框架中的核心组件DispatcherServlet的自动配置类DispatcherServletAutoConfiguration
在这里插入图片描述
在 DispatcherServletAutoConfiguration 这个类上添加了一个@AutoConfiguration和@ConditionalOnClass(DispatcherServlet.class)注解
在这里插入图片描述
其中@AutoConfiguration注解就是对@Configuration的一个封装，为了让其更加见名知意，说明这个类就是为了完成自动配置的。

@AutoConfiguration 注解是 Spring Boot 提供的一个重要注解，用于标记一个配置类，使其成为自动配置的一部分。它的主要作用和特点如下：

  1. 自动配置：
    标记的类会被 Spring Boot 的自动配置机制识别。
    Spring Boot 会根据应用的依赖和环境自动应用这些配置，减少手动配置的工作量。
  2. 条件化配置：
    通常与 @Conditional 注解一起使用。
    使得配置类只有在满足特定条件时才会被加载和应用，提高了配置的灵活性和适应性。
  3. 见名知意：
    @AutoConfiguration 注解使得配置类的用途更加明确和直观，表明该类是为了完成自动配置> 的。
    开发人员可以一目了然地知道某个类的作用，提高代码的可读性和可维护性。
  4. 集成第三方库：
    通过 @AutoConfiguration 注解，可以轻松地集成第三方库，而不需要手动编写大量的配置代码。

另外，还一个注解@ConditionalOnClass(DispatcherServlet.class)，意思是如果我们的环境中有DispatcherServlet，才会注入 DispatcherServletAutoConfiguration 的bean对象，否则不会生效
在这个自动配置类中，我们还可以找到一个@EnableConfigurationProperties(xxxProperties.class)
在这里插入图片描述

@EnableConfigurationProperties VS @ConfigurationProperties

  • 在@ConfigurationProperties的使用，把配置类的属性与yml配置文件绑定起来的时候，还需要加上@Component注解才能绑定并注入IOC容器中，若不加上@Component，则会无效。
  • @EnableConfigurationProperties，则是快速实现属性配置绑定，只要加上该注解，即可完成属性绑定，无需加@Component，更多用于导入第三方写好的组件进行属性绑定。
    因为SpringBoot默认只扫描自己主程序所在的包。如果导入第三方包，即使组件上标注了 @Component、@ConfigurationProperties 注解，也没用。因为组件都扫描不进来，此时使用这个注解就可以快速进行属性绑定并把组件注册进容器

结论：
SpringBoot通过@Conditional注解，实现自动配置类的按需生效。并通过@EnableConfigurationProperties注解实现组件的核心参数与配置文件进行绑定，从而实现只需要该配置文件的值，对应核心组件的底层参数都会被修改的效果。

@ComponentScan

组件扫描：排除一些组件（排除前面已经扫描进来的配置类、和自动配置类）

@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
		@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })

四、总结

在这里插入图片描述
核心流程总结：

  1. 导入starter，就会导入autoconfigure包。
  2. autoconfigure 包里面 有一个文件 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports,里面指定的所有启动要加载的自动配置类
  3. @EnableAutoConfiguration 会自动的把上面文件里面写的所有自动配置类都导入进来。xxxAutoConfiguration 是有条件注解进行按需加载
  4. xxxAutoConfiguration给容器中导入一堆组件，组件都是从 xxxProperties中提取属性值
  5. xxxProperties又是和配置文件进行了绑定
@Repository注解：Spring框架中的数据访问组件自动化，有两下子！
**My Coding Family**
05-26 1087
🏆本文收录于《滚雪球学Spring Boot》，专门攻坚指数提升，2025 年国内最系统+最强（更新中）。    本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中…欢迎大家订阅持续学习。 如果想快速定位学习，可以看这篇【SpringBoot教程导航帖】,你想学习的都被收集在内，快速投入学习！！两不误。
SpringBoot自动装配原理
04-05 1932
配合@EnableAutoConfiguration注解使用时，它主要扮演的是配置查找器的角色。这个注解利用其自身的完整类名org.springframework.boot.autoconfigure.EnableAutoConfiguration作为搜索的关键词（Key），来定位并加载一组相关的@Configuration类。SpringBoot的自动装配主要依赖于Spring框架的条件配置（Conditional Configuration）和Java的配置类（Java Config）功能。
SpringBoot篇（自动装配原理）
m0_74824496的博客
03-22 1261
自动装配简单来说就是自动把第三方组件的bean加到IOC容器里，在springboot项目中可以通过在启动类上加@SpringBootApplication注解来实现自动装配，这个注解是一个组合注解，真正实现自动装配的注解是步骤一：main方法中SpringApplication.run(xxx.class,args)的执行流程中有refreshContext(context)。
19.SpringBoot自动配置原理详解教程
最新发布
yk_dflkg的博客
07-11 313
SpringBoot自动配置是SpringBoot框架的核心特性之一，它能够根据类路径上的依赖、配置文件中的配置以及其他条件，自动为应用程序配置所需的Bean和组件。这大大简化了Spring应用的配置工作，实现了"约定优于配置"的理念。// 自定义条件类@Override// 使用自定义条件@Bean// 配置属性类// getter和setter方法...// 服务类if (!// 自动配置类@Bean: 启动自动配置的入口: 选择和加载自动配置类。
Spring Boot 自动装配原理
林心涯的博客
01-20 3855
Spring Boot 自动装配原理 每次问到 Spring Boot， 面试官非常喜欢问这个问题：“讲述一下 SpringBoot 自动装配原理？”。 我觉得我们可以从以下几个方面回答： 什么是 SpringBoot 自动装配？ SpringBoot 是如何实现自动装配的？如何实现按需加载？ 如何实现一个 Starter？ 前言 使用过 Spring 的小伙伴，一定有被 XML 配置统治的恐惧。即使 Spring 后面引入了基于注解的配置，我们在开启某些 Spring
【SpringBoot篇】springboot的自动装配原理
热门推荐
小吉妙妙屋
01-26 1万+
自动装配（Auto-Configuration）是Spring Boot框架的一个核心特性之一，它通过扫描应用程序的classpath和依赖关系，自动配置和装配Spring应用程序所需的各种组件在传统的Spring应用程序中，开发者需要手动配置大量的bean，例如数据源、事务管理器、视图解析器等。这些配置过程繁琐而容易出错，加大了开发难度和成本。而Spring Boot的自动装配机制则能够自动完成这些配置过程，使得开发者可以更加专注于业务逻辑的实现。
【springboot】springboot 自动装配原理
zzd13546036394的博客
03-27 3689
springboot 大大降低了我们项目搭建成本，也对常用的框架版本进行了管理。我们引入常用框架也只是在 Maven 中引入一个 starter jar 包，然后配置好关键配置，如数据源地址、用户名、密码等，就可以使用。我们自己在工作中的也可以下一个 starter 供项目使用，极大方便了日常的开发。而上面的一切都指向了 springboot 的自动装配功能，可以说没有自动装配功能就没有 springboot。甚至可以说 springboot 的自动装配是微应用的一个基石。
四篇文章带你玩转springboot——2自动装配解决Bean的复杂配置
Eclipse_2019的博客
06-14 814
一文弄懂自动装配原理
倾情力作-一文读懂SpringBoot2源码-基础入门-自动配置原理
Fatter$hday的博客
03-26 1361
SpringBoot2核心技术-基础入门-自动配置原理 我们都知道SpringBoot自动给我们导入了许多的组件，那么这些组件是怎么导入的呢？是从哪里导入的？本文将带你一探究竟，彻底明白SpringBoot的自动配置原理。
SpringBoot成长记8：SpringBoot实现自动装配配置，第三方功能的扩展之处
rita_0567的博客
08-25 1002
在看第一步之前，你可以思考下，我们定义的Bean是不是通常有以下几种@Bean+@Configuration注解定义的，@Service，@Controller等注解定义的、也有用xml、groovy定义的bean而且可以通过@Import，@ImportResource导入其他的xml或者JavaConfig定义的Bean，@ComponentScan指定扫描Bean的路径等等。也就是说有一大堆注解需要我们分析和解析。这个是需要一个解析器和扫描器来进行的。
SpringBoot成长记1：你真的懂SpringBoot吗?
qq_24428851的博客
07-02 563
刚才通过官方的介绍，你知道了Springboot的是为了更好的便利的使用Spring，创建应用程序。那它提供了什么功能，让我们更好的使用Spring呢？这个当然是作者给出的回答最好了。通常你可以通过一个技术的官方文档来了解它。SpringBoot的官方文档，编写的还是非常好的。官方文档是非常详细的，就像一本书一样，我们怎么找到我们想要的知识点呢？其实思路很简单，找下目录，就和我们看书一样，或者看课程目录一样，先大体过一下目录，就知道自己想要的只是在哪里了。先脉络后细节的思想是我一直在强调的。
02原理篇（D2_SpringBoot 自动装配原理）
思维码途
10-29 7114
自动装配简单来说就是自动把第三方组件的bean加到IOC容器里，在springboot项目中可以通过在启动类上加@SpringBootApplication注解来实现自动装配，这个注解是一个组合注解，真正实现自动装配的注解是步骤一：main方法中SpringApplication.run(xxx.class,args)的执行流程中有refreshContext(context)。
SpringBoot的自动装配原理
黄帅帅的博客
04-23 949
SpringBoot的自动装配原理
Spring Boot自动装配原理
qq_63688997的博客
07-24 2355
Spring Boot的自动转配原理深究以及总结。
Spring Boot 自动装配原理详解
error_log7的博客
03-08 2277
自动装配是 Spring Boot 根据项目类路径（classpath）中的依赖和当前环境，动态配置 Spring 应用程序所需 Bean 的过程。它通过注解实现，通常被包含在中。核心功能：根据引入的依赖，自动加载和配置相关组件。典型场景：添加后，Spring Boot 自动配置 Tomcat 和 Spring MVC。// 文件: org.springframework.boot.autoconfigure.EnableAutoConfiguration。
面试必备：一文读懂DNS：网络知识扫盲
网络知识扫盲，一文搞懂DNS，是求职面试中不容忽视的基础考察内容。DNS（Domain Name System），即域名解析系统，是互联网通信的核心组成部分，它将人类易于记忆的域名转换为机器可理解的IP地址，使得我们在浏览器中...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值