07-Spring Boot 自动配置原理全解析

Spring Boot 自动配置原理全解析（@EnableAutoConfiguration 源码追踪）

Spring Boot 之所以能大幅简化配置，核心就在于它的 自动配置机制，而这一机制背后主要依赖于 @EnableAutoConfiguration 注解。本文将从使用、源码、常见问题及面试视角全方位解构这一机制。

一、自动配置的核心注解

Spring Boot 中最核心的注解是：

@SpringBootApplication

实际上它是组合注解：

@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan

其中的 @EnableAutoConfiguration 是自动配置的关键，表示让 Spring Boot 根据项目所依赖的 jar 包以及自定义配置来“猜测”你想如何配置 Spring 应用。

二、@EnableAutoConfiguration 的工作机制

2.1 核心：@Import(AutoConfigurationImportSelector.class)

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

说明：Spring 会在启动时执行 AutoConfigurationImportSelector 的 selectImports 方法，将所有自动配置类注入容器。

2.2 自动配置类的加载来源

核心入口在 META-INF/spring.factories 文件：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration,org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration,...

// AutoConfigurationImportSelector.java
List<String> configurations = SpringFactoriesLoader.loadFactoryNames(EnableAutoConfiguration.class, classLoader);

📌 小贴士：SpringFactoriesLoader 是 SPI 的变体，负责加载 `spring.factories` 文件内容。

三、条件化装配：@Conditional 注解体系

自动配置类内部基本都配合使用了一系列条件注解，比如：

@Configuration
@ConditionalOnClass(DataSource.class)
@ConditionalOnMissingBean(DataSource.class)
public class DataSourceAutoConfiguration { ... }

这说明自动配置并不是“强制生效”，而是“条件成立时才配置”。常见条件注解有：

@ConditionalOnClass
@ConditionalOnMissingBean
@ConditionalOnProperty
@ConditionalOnWebApplication

✅ 可插拔、可控制、可扩展，才是 Spring Boot 自动配置的精髓。

四、源码流程简要梳理

SpringApplication#run() 启动入口
调用 prepareContext()，执行 load() 方法加载 Bean 定义
读取 @EnableAutoConfiguration 注解
触发 AutoConfigurationImportSelector#selectImports()
加载所有 spring.factories 中配置的自动配置类
加入 IOC 容器等待后续的条件判断装配

五、实战示例：自定义自动配置

5.1 创建配置类

@Configuration
@ConditionalOnProperty(name = "my.feature.enabled", havingValue = "true")
public class MyFeatureAutoConfiguration {@Beanpublic MyService myService() {return new MyService();}
}

5.2 注册自动配置类

在 resources/META-INF/spring.factories 中添加：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.autoconfig.MyFeatureAutoConfiguration

六、高频面试问答（嵌入讲解）

💬 Q：Spring Boot 是如何实现自动配置的？

🧠 A：通过 @EnableAutoConfiguration + AutoConfigurationImportSelector 加载 spring.factories 中定义的自动配置类，借助 @Conditional 实现“按需装配”。

💬 Q：如何排除某个自动配置类？

🧠 A：使用注解属性：
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})

💬 Q：spring.factories 是在什么时候被加载的？

🧠 A：在 AutoConfigurationImportSelector 执行时由 SpringFactoriesLoader 读取 classpath 下的 META-INF/spring.factories 文件。