← 课程目录 🚀 从零到一
📐 学习维度 阶段4 · 第14章 Spring Boot 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

14.1 Spring Boot 自动装配原理

审校 2026-09-25 · 素材来源:L课SpringBoot体系(底稿改写)、SpringBoot入门(松哥)、2026真题_16
📑 本篇章节导航 (共9节,点击直达)
从 @SpringBootApplication 拆起装配流程五步条件装配:裁缝的三把尺最小验证:亲手看一次报告与手写 Spring 的对照踩坑清单踩坑清单面试怎么问一句话总结

引一个 mysql-connector 加几行配置,DataSource、事务管理器全都有了——没写一行装配代码。这就是 Spring Boot 的招牌自动装配(按 classpath 里的依赖和你的配置,自动决定容器里注册哪些 Bean 的机制)。面试问 Boot,第一问几乎必是它。

从 @SpringBootApplication 拆起

这个注解是三合一:@Configuration(配置类本体)+ @ComponentScan(扫描你自己的包)+ @EnableAutoConfiguration(自动装配开关)。前两个是 Spring 老功能,真正的魔法全在第三个。

13.1 埋的伏笔在这兑现:@EnableAutoConfiguration 本质是 @Import(AutoConfigurationImportSelector.class)——一个 ImportSelector(返回一批类名批量导入容器的选择器,13.1 讲过它的身份)。所以自动装配的入口不是扫描,是 Import:把一批官方预备好的配置类塞进容器。

装配流程五步


① 启动 → AutoConfigurationImportSelector.selectImports()
② 读 META-INF/spring/org.springframework.boot.autoconfigure
   .AutoConfiguration.imports(2.7+;旧版读 spring.factories)
③ 得到 ~150+ 个候选自动配置类(全限定名一行一个)
④ @Conditional 条件逐个过滤——大部分被拦下
⑤ 幸存者注册为 BeanDefinition → refresh 实例化

关键认知有两层。第一层:候选列表是文件写死的,不是运行时猜的——一个 imports 文件列了所有可能的配置类。第二层:真正决定「你的应用装配了什么」的是第④步的条件过滤——引了 HikariCP 才轮到 DataSourceAutoConfiguration,配了 spring.datasource.url 才真的建数据源。

这个 imports 文件的机制学名 SPI(Service Provider Interface:以约定路径的清单文件声明实现、由框架统一加载的扩展点机制)。它不是 Boot 发明的——JDK 的 JDBC 驱动加载(META-INF/services/java.sql.Driver)就是同款:MySQL 驱动 jar 里放一个清单文件,DriverManager 启动时扫描所有 jar 的约定路径,把驱动全找出来。Boot 把这个思路搬到配置类上:谁想贡献自动配置,谁就在自己 jar 的约定路径下放清单,主程序一次读齐。这也解释了为什么加一个 starter 依赖就能「无感」接入——依赖 jar 里除了代码,还揣着一张装配清单。

看一眼清单文件长什么样(截两行感受格式):


org.springframework.boot.autoconfigure.jdbc
    .DataSourceAutoConfiguration
org.springframework.boot.autoconfigure.web.servlet
    .WebMvcAutoConfiguration

一行一个全限定类名,没有别的语法。2.7 之前这套清单写在 META-INF/spring.factories 里,格式是 key=逗号分隔的类名列表;2.7 起官方把它拆成独立的 imports 文件——一文件一职责,加载也更快(不用解析 properties 的多 key 结构)。面试被追问「两个文件什么关系」,答「同一 SPI 思想的两次文件格式迭代」即可。

条件装配:裁缝的三把尺

三个最高频的条件注解,各管一件事:

类比为自助餐厅:中央厨房预做了 150 多道菜(候选配置类),服务员看你桌上有什么食材(classpath 依赖)决定上哪几道;你自己带了菜(自定义 Bean),餐厅那道就不上了(MissingBean 让位)。自动装配 = 预制 + 按需上桌,不是玄学。

拿 DataSourceAutoConfiguration 的真实源码节选感受裁缝手艺:


@AutoConfiguration
@ConditionalOnClass(DataSource.class)          // 有jdbc才装配
@EnableConfigurationProperties(DataSourceProperties.class)
public class DataSourceAutoConfiguration {

    @Configuration(proxyBeanMethods = false)
    @Conditional(PooledDataSourceCondition.class)
    static class PooledDataSourceConfiguration { ... }
}

三层条件叠着用:类存在、属性绑定(DataSourceProperties 接住 spring.datasource.* 前缀)、池化条件——一层层收窄到「最终给你一个 HikariDataSource」。读官方自动配置类的源码是学条件装配的最快路径,通篇都是这个模式。

还有一把容易被忽略的尺子:顺序控制。@AutoConfigureBefore / @AutoConfigureAfter 声明配置类之间的先后(如 WebMvcAutoConfiguration 要在 DispatcherServletAutoConfiguration 之后处理),@AutoConfigureOrder 控数字序。注意它们管的是自动配置类之间的加载排序——与你自己的 @Bean 定义顺序无关,用户配置永远先于自动配置评估,这正是 MissingBean 让位能成立的前提:先声明者赢,官方只做兜底。

最小验证:亲手看一次报告


# 启动加 --debug,打印条件装配报告
java -jar app.jar --debug

# 报告分三段:
# Positive matches  —— 条件命中,装配了的
# Negative matches  —— 条件没过,没装配的(附原因)
# Unconditional classes —— 无条件装配的

排查「为什么我的 Bean 没被装配」,对着 Negative matches 找原因,比盲猜快一个量级。再配一个排除实验:


@SpringBootApplication(exclude = {
    DataSourceAutoConfiguration.class   // 不要数据源(如纯工具类应用)
})

排除后启动报 DataSourceAutoConfiguration not found 之类,说明确实关掉了——自动装配是可精确干预的,不是全有或全无。

与手写 Spring 的对照

13.1 里手写过 AnnotationConfigApplicationContext(AppConfig.class)——那时装配靠你自己在配置类里 @Bean。Boot 做的事:把官方最佳实践的 @Bean 收进 150 个配置类,用条件注解按需激活。理解这一点,「Boot 就是 Spring 加一层约定」就不是口号:容器还是那个容器,refresh 还是那个 refresh(13.1 的五步流程原样成立),多的是图纸的批量供应。

对照着算一笔「装配代码量」的账。纯 Spring 时代接一个 MySQL,你要写:数据源 @Bean、事务管理器 @Bean、MyBatis 的 SqlSessionFactory @Bean、扫描 Mapper 的 @MapperScan——四段样板代码,每个项目抄一遍,抄错一处启动就红。Boot 时代同样的事:引 mybatis-spring-boot-starter、写两行 yaml(url 和密码),完了。省下的不是魔法,是把四段样板收编进了 MybatisAutoConfiguration 的条件装配里——代码没有消失,只是从你的项目搬进了框架的 jar,由条件注解保证「该生效时生效」。

这也给出读 Boot 源码的正确姿势:不要从启动流程硬啃,先挑一个熟悉的场景(如 WebMvc)打开对应 AutoConfiguration 类,看它装配了哪些 Bean、挂了哪些条件——每个配置类都是一份「官方觉得该这么配」的参考答案,比任何教程都权威。

踩坑清单

踩坑清单

面试怎么问

一句话总结

自动装配 = ImportSelector 批量导入 150+ 预制配置类 + @Conditional 按 classpath 与配置裁剪——预制按需上桌,容器和 refresh 还是 13.1 那套老骨头。