第78篇Spring Boot自动配置2026版系列导航《Java 100 天进阶之路》完整目录 |⬅️ 上一篇第77篇Spring MVC流程 |➡️ 下一篇第79篇Spring源码阅读技巧️ 本文阅读地图3 分钟速览第77篇搞定了Spring MVC流程本篇深入Spring Boot自动配置原理。每天用SpringBootApplication启动项目引入依赖就能自动装配各种功能——但你知道这背后的魔法是怎么运作的吗搞懂自动配置就是搞懂了Spring Boot“约定优于配置”的底层逻辑模块核心问题一句话回答自动配置是什么为什么引入依赖就能直接用Spring Boot启动时根据classpath中的依赖自动创建和配置需要的BeanSpringBootApplication一个注解干了多少事复合注解——集成了SpringBootConfiguration、EnableAutoConfiguration、ComponentScan三个核心注解EnableAutoConfiguration自动配置的开关是什么通过Import(AutoConfigurationImportSelector.class)导入配置选择器触发自动配置加载SPI机制自动配置类怎么被发现的Spring Boot启动时扫描类路径下的META-INF/spring.factories或.imports文件条件注解为什么有的配置加载有的不加载通过ConditionalOnClass、ConditionalOnMissingBean等条件注解按需装配配置绑定配置文件怎么绑定到Java对象ConfigurationProperties将application.yml的属性映射到XxxProperties类Spring Boot 3.x变化和2.x有什么不同废弃spring.factories改用AutoConfiguration.imports文件面试最爱问高频考点有哪些见文末 小节一、核心知识点1. 什么是自动配置自动配置Auto-Configuration是Spring Boot最核心的能力——它根据类路径中存在的依赖、容器中已存在的Bean以及配置文件中的属性自动创建和配置Spring Bean避免了大量手动XML或Java配置。核心思想“约定优于配置”Convention over Configuration——Spring Boot预设了大量合理的默认值你只需要在需要的时候覆盖它们。2. 为什么需要自动配置在Spring Boot出现之前Spring应用的配置有多繁琐对比维度传统SpringSpring BootWeb应用配置配置web.xml、DispatcherServlet、ViewResolver引入spring-boot-starter-web即可数据源配置配置DataSource、事务管理器、SessionFactory引入spring-boot-starter-data-jpa配几个连接参数即可JSON支持手动配置Jackson的HttpMessageConverter自动注入开箱即用3. 自动配置的三大基石Spring Boot的自动配置建立在三个核心能力之上基石说明SpringBootApplication应用入口与核心注解聚合自动配置机制基于条件化的Bean自动注册SPI扩展机制Spring Boot与Spring Framework的底层扩展能力二、通俗讲解1分钟开心学把Spring Boot自动配置想象成“智能家居”传统Spring你买了一套毛坯房要自己装水电、铺地板、刷墙、买家具——每样都得自己干写XML配置。Spring Boot你买了一套精装智能公寓。进门时系统自动检测——检测到“有人入住”项目启动自动开灯自动配置、联网嵌入式Tomcat、配好智能音箱Starter依赖——你拎包入住就行。自动配置的“智能检测”逻辑检测到有Tomcat依赖→ 自动配置Spring MVC检测到有MySQL驱动→ 自动配置数据源检测到有Redis客户端→ 自动配置RedisTemplate检测到你自己配了数据源→ 用你的不用默认的ConditionalOnMissingBean把核心组件想象成“智能家居的中控系统”组件比喻SpringBootApplication智能家居的“总开关”EnableAutoConfiguration“自动模式”按钮——开启全屋智能AutoConfigurationImportSelector“中央处理器”——决定开哪些设备META-INF/.../AutoConfiguration.imports“设备清单”——所有可用的智能设备列表ConditionalOnXxx“传感器”——检测条件是否满足才启动设备ConfigurationProperties“控制面板”——你在手机上调整的参数三、SpringBootApplication 注解详解3.1 注解本质复合注解SpringBootApplication是Spring Boot的入口注解本质上是一个复合注解元注解由三个核心注解组合而成Target(ElementType.TYPE)Retention(RetentionPolicy.RUNTIME)DocumentedInheritedSpringBootConfigurationEnableAutoConfigurationComponentScan(excludeFilters{Filter(typeFilterType.CUSTOM,classesTypeExcludeFilter.class),Filter(typeFilterType.CUSTOM,classesAutoConfigurationExcludeFilter.class)})publicinterfaceSpringBootApplication{// 继承自三个注解的属性}3.2 三个核心组成注解注解作用关键特性SpringBootConfiguration标记类为Spring Boot配置类继承自ConfigurationSpring Boot 3.x中默认使用CGLIB代理模式EnableAutoConfiguration启用Spring Boot自动配置核心注解通过SPI机制加载自动配置类ComponentScan扫描指定包下的Spring组件默认扫描主类所在包及其子包关键理解SpringBootApplication的本质就是这三个注解的“打包”——你写一个注解等于同时开启了配置类、自动配置和组件扫描。3.3 常用属性属性作用示例exclude排除指定的自动配置类SpringBootApplication(exclude DataSourceAutoConfiguration.class)excludeName通过全类名排除自动配置类SpringBootApplication(excludeName org...)scanBasePackages指定组件扫描的基础包SpringBootApplication(scanBasePackages com.example)proxyBeanMethods是否代理Bean方法Spring Boot 3.x默认true四、自动配置执行流程6步自动配置的本质是在Spring应用启动时根据类路径下的依赖、配置文件和环境变量自动注册符合条件的Bean到Spring容器中。核心链路SpringBootApplication→EnableAutoConfiguration→Import(AutoConfigurationImportSelector.class)→selectImports()→ SPI加载 → 条件过滤 → Bean注册五、核心组件深度拆解5.1 EnableAutoConfiguration —— 自动配置的“开关”EnableAutoConfiguration是Spring Boot自动配置的核心注解Target(ElementType.TYPE)Retention(RetentionPolicy.RUNTIME)DocumentedInheritedAutoConfigurationPackageImport(AutoConfigurationImportSelector.class)publicinterfaceEnableAutoConfiguration{// ...}真正的魔法来自它导入的AutoConfigurationImportSelector。5.2 AutoConfigurationImportSelector —— 自动配置的“CPU”AutoConfigurationImportSelector实现了DeferredImportSelector接口会在所有Configuration配置类处理完之后再执行导入逻辑。它的核心方法是selectImports()负责检查自动配置是否开启加载所有自动配置候选类通过SPI机制返回需要导入的配置类数组5.3 SPI机制 —— 自动配置类的“发现”方式Spring Boot通过SPIService Provider Interface机制发现自动配置类。Spring Boot 2.x及之前自动配置类定义在META-INF/spring.factories文件中# META-INF/spring.factories org.springframework.boot.autoconfigure.EnableAutoConfiguration\ org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,\ org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfigurationSpring Boot 3.x重要变化Spring Boot 3.0正式废弃了META-INF/spring.factories机制改用新的声明式配置文件# META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration⚠️特别注意如果你在维护或升级Spring Boot 3.x项目自动配置的注册方式已经变了——不再是spring.factories而是.imports文件。5.4 条件注解 —— 自动配置的“过滤器”所有自动配置类都附带条件注解只有满足条件才会真正生效实现按需装配。条件注解作用典型场景ConditionalOnClassclasspath中存在指定类才生效引入MySQL驱动才加载数据源配置ConditionalOnMissingBean容器中没有用户自定义的Bean才生效用户没配数据源时Spring Boot才创建默认的ConditionalOnProperty配置文件中指定参数才生效spring.redis.enabledtrue时才加载Redis配置ConditionalOnBean容器中存在指定Bean才生效存在DataSource时才创建JdbcTemplateConditionalOnWebApplication当前是Web应用才生效MVC自动配置只在Web环境下生效代码示例ConfigurationConditionalOnClass(DataSource.class)// 有DataSource类才加载ConditionalOnMissingBean(DataSource.class)// 用户没配才创建默认的EnableConfigurationProperties(DataSourceProperties.class)publicclassDataSourceAutoConfiguration{BeanConditionalOnProperty(namespring.datasource.url)publicDataSourcedataSource(DataSourcePropertiesproperties){returnproperties.initializeDataSourceBuilder().build();}}5.5 ConfigurationProperties —— 配置绑定每个自动配置类都配套一个XxxProperties属性封装类用于将application.yml中的配置绑定到Java对象ConfigurationProperties(prefixspring.datasource)publicclassDataSourceProperties{privateStringurl;privateStringusername;privateStringpassword;// getters / setters}在application.yml中配置spring:datasource:url:jdbc:mysql://localhost:3306/testusername:rootpassword:123456Spring Boot自动将配置值绑定到DataSourceProperties对象然后DataSourceAutoConfiguration从中读取参数创建数据源。六、Spring Boot 3.x 重要变化Spring Boot 3.x基于Spring Framework 6和JDK 17构建在自动配置方面有重大变化变化点Spring Boot 2.xSpring Boot 3.x自动配置文件META-INF/spring.factoriesMETA-INF/spring/.../AutoConfiguration.importsJava EE包名javax.*jakarta.*JDK基线JDK 8/11JDK 17GraalVM支持有限支持原生镜像AOT元数据虚拟线程不支持支持升级提醒如果你正在将Spring Boot 2.x项目升级到3.x自动配置的spring.factories需要迁移到.imports文件。七、自定义Starter实战理解了自动配置原理就可以自己写一个Starter了。Starter本质上是一个特殊的Maven/Gradle依赖项通过聚合相关依赖和自动配置逻辑实现特定功能的“一键启用”。7.1 自定义Starter四步走步骤做什么核心代码①编写XxxProperties配置属性类ConfigurationProperties(prefix xxx)②编写XxxAutoConfiguration自动配置类Configuration 条件注解 Bean③注册自动配置类Spring Boot 3.x在.imports文件中添加全类名④添加spring-boot-autoconfigure-processor依赖生成自动配置元数据7.2 完整代码示例① 配置属性类ConfigurationProperties(prefixsms)publicclassSmsProperties{privateStringapiKey;privateStringapiSecret;privateStringapiUrl;privateIntegerconnectTimeout5000;// getters / setters}② 自动配置类ConfigurationConditionalOnClass(SmsClient.class)EnableConfigurationProperties(SmsProperties.class)publicclassSmsAutoConfiguration{BeanConditionalOnMissingBeanpublicSmsClientsmsClient(SmsPropertiesproperties){SmsClientclientnewSmsClient();client.setApiKey(properties.getApiKey());client.setApiSecret(properties.getApiSecret());client.setApiUrl(properties.getApiUrl());client.setConnectTimeout(properties.getConnectTimeout());returnclient;}}③ 注册自动配置Spring Boot 3.x在src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports中写入com.example.sms.autoconfigure.SmsAutoConfiguration④ 使用者体验引入依赖后只需要在application.yml中配置sms:api-key:your-api-keyapi-secret:your-api-secretapi-url:https://api.sms.com然后直接Autowired使用即可0行配置代码。八、避坑要点错误/误区后果正确做法不知道Spring Boot 3.x已废弃spring.factories自定义Starter在3.x中不生效改用.imports文件在ConfigurationProperties类上忘记加Component属性绑定不生效配合EnableConfigurationProperties使用条件注解使用不当导致配置不加载自动配置“失灵”检查classpath中是否有对应的依赖类在ConditionalOnClass中直接引用类类不存在时导致编译失败使用name属性指定类名字符串忘记添加spring-boot-autoconfigure-processor自动配置元数据缺失在Starter模块中添加该依赖把ConditionalOnMissingBean放在Configuration类上整个配置类被跳过放在Bean方法上更精准九、面试高频考点Q1Spring Boot自动配置的原理是什么Spring Boot启动时SpringBootApplication中的EnableAutoConfiguration通过Import(AutoConfigurationImportSelector.class)导入配置选择器。AutoConfigurationImportSelector.selectImports()方法通过SPI机制扫描类路径下的META-INF/spring.factories2.x或AutoConfiguration.imports3.x文件加载所有自动配置候选类。然后通过Conditional系列条件注解进行筛选只有满足条件的配置类才会生效最终将Bean注册到IoC容器中。Q2SpringBootApplication注解包含哪些核心注解包含三个核心注解①**SpringBootConfiguration**——标记类为Spring Boot配置类继承自Configuration②**EnableAutoConfiguration**——开启自动配置的核心开关③**ComponentScan**——扫描主类所在包及其子包下的组件。Q3Spring Boot 3.x在自动配置方面有什么重大变化最大变化是废弃了META-INF/spring.factories。Spring Boot 3.x改用新的声明式配置文件META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports每行写一个自动配置类的全限定名。此外所有javax.*包名改为jakarta.*JDK基线升级到17。Q4ConditionalOnMissingBean的作用是什么当IoC容器中不存在指定类型的Bean时条件成立。这是实现“可覆盖默认实现”的核心注解——Spring Boot提供默认Bean但如果开发者自己定义了同类型的Bean就会覆盖默认的。Q5如何自定义一个Starter四步①编写XxxProperties配置属性类用ConfigurationProperties绑定配置②编写XxxAutoConfiguration自动配置类用Configuration条件注解Bean定义Bean③在Spring Boot 3.x中在META-INF/spring/.../AutoConfiguration.imports中注册自动配置类的全限定名④添加spring-boot-autoconfigure-processor依赖生成元数据。 面试官追问陷阱加分题追问1“AutoConfigurationImportSelector和普通的ImportSelector有什么不同”AutoConfigurationImportSelector实现的是**DeferredImportSelector** 接口它是ImportSelector的子接口。关键区别在于执行时机——DeferredImportSelector会在所有Configuration类处理完之后再执行。这样做的目的是让自动配置类可以感知到用户自定义的Bean从而实现“用户定义优先”的覆盖机制ConditionalOnMissingBean正是依赖这个特性。追问2“spring.factories和AutoConfiguration.imports有什么区别为什么要改”spring.factories是一个key-value格式的通用SPI文件不仅用于自动配置还用于各种扩展点如ApplicationListener、FailureAnalyzer等。.imports文件是纯列表格式只用于自动配置。改的原因①更简洁不需要写key②加载性能更好③避免spring.factories文件中无关配置的干扰。追问3“如果我自己配了一个DataSourceBeanSpring Boot还会创建默认的数据源吗”不会。因为Spring Boot的DataSourceAutoConfiguration上使用了ConditionalOnMissingBean(DataSource.class)——当容器中已经存在DataSource类型的Bean时这个条件不成立自动配置类不会生效。这就是“开发者自定义优先于框架默认”的设计哲学。十、练习题简答题请简述Spring Boot自动配置的完整执行流程从SpringBootApplication到Bean注册。代码题编写一个自定义Starter实现一个简单的“日志记录工具”——引入依赖后自动注入一个LogUtilBean支持通过application.yml配置日志级别和输出格式。分析题某项目从Spring Boot 2.7升级到3.0后自定义的Starter不生效了。请分析可能的原因并给出解决方案。 你的学习进度当前第78篇 / 共108篇 ·进阶篇Spring全家桶第73~82篇✅ 已完成基础篇44篇 第45~78篇 正在学第78篇⏳ 待学习第79~108篇 完整目录 学习指南 | 订阅本专栏不错过每一篇 下一篇文章预告下一篇《第79篇Spring源码阅读技巧》内容简介Spring源码阅读方法论——如何调试Spring源码、关键类与关键方法速查AbstractApplicationContext、BeanFactory、断点技巧、常见源码阅读误区。Spring全家桶专题持续推进拿下Spring源码《Java 100 天进阶之路 | 从入门到上岗就业》每天一篇建议收藏 关注一起100天拿offer 点击关注我更新后第一时间收到推送