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 自動配置的精髓。

---

四、源碼流程簡要梳理

1. SpringApplication#run() 啟動入口
2. 調用 prepareContext()，執行 load() 方法加載 Bean 定義
3. 讀取 @EnableAutoConfiguration 注解
4. 觸發 AutoConfigurationImportSelector#selectImports()
5. 加載所有 spring.factories 中配置的自動配置類
6. 加入 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 文件。

---

💬 Q：自動配置和手動配置沖突怎么辦？

🧠 A：Spring Boot 優先尊重開發者的配置，通常使用 @ConditionalOnMissingBean 避免重復注入。

---

七、總結

• Spring Boot 自動配置依賴 @EnableAutoConfiguration 注解驅動。
• 自動配置類來源于 spring.factories 文件。
• 條件注解保證了配置的靈活性。
• 支持用戶自定義配置類并自動裝配。

🧩 掌握了自動配置機制，不僅能更高效排查啟動過程中的問題，還能在需要時開發屬于自己的 “starter”。