在使用 Spring Boot 進行開發時，我們常常會引入諸如 spring-boot-starter-web、spring-boot-starter-data-jpa 等依賴，從而快速開啟相關功能模塊。但你是否思考過這些 Starter 是如何構建的？如果我們要開發自己的 Starter，又該如何入手？
本文將從原理與實踐兩個角度，詳細解析 Spring Boot Starter 的生成機制，并帶你一步步創建一個自定義 Starter。
一、什么是 Spring Boot Starter？
Spring Boot 的 Starter 本質上是一組 預定義的依賴集合，旨在通過統一封裝常用的配置、Bean 和依賴庫，降低上手成本，提高項目的一致性與開發效率。
常見 Starter 示例：
| Starter 名稱 | 功能 |
|---|---|
| spring-boot-starter-web | 包含 Spring MVC、Jackson、嵌入式 Tomcat 等 |
| spring-boot-starter-data-jpa | 包含 Spring Data JPA、Hibernate 等 |
| spring-boot-starter-test | 包含 JUnit、Mockito 等測試庫 |
本質：
Starter 本質上就是一個 Maven 或 Gradle 的普通依賴，通常由以下結構組成：
- 自動配置類（
@Configuration+@Conditional*） - Spring Factories 注冊文件
- 相關依賴
二、Starter 的核心機制原理
1. 自動配置（Auto Configuration）
Spring Boot 的自動配置依賴于兩個核心組件：
@EnableAutoConfigurationspring.factories中配置的自動配置類
Spring Boot 啟動時會掃描依賴中的 META-INF/spring.factories 文件，并加載其中聲明的 EnableAutoConfiguration 類。
# spring-boot-autoconfigure 包中
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.autoconfig.MyServiceAutoConfiguration
2. 條件注解（@Conditional 系列）
Starter 中的自動配置通常不是強制生效的，而是基于條件。例如：
@Configuration
@ConditionalOnClass(MyService.class) // 僅當 classpath 中存在該類時才生效
@ConditionalOnMissingBean(MyService.class) // 若用戶未定義此 bean 時自動配置
public class MyServiceAutoConfiguration {@Beanpublic MyService myService() {return new MyService();}
}
Spring Boot 提供了豐富的條件注解，如：
@ConditionalOnClass@ConditionalOnMissingBean@ConditionalOnProperty@ConditionalOnResource
這使得 Starter 能夠根據用戶配置進行動態裝配，具備高度靈活性。
三、自定義 Spring Boot Starter 實踐
1. 創建兩個模塊
我們推薦將 Starter 分為兩個模塊：
（1）my-spring-boot-starter-autoconfigure
- 包含核心配置類、Bean、
spring.factories - 不依賴 Spring Boot Starter 本身，便于獨立測試和復用
（2）my-spring-boot-starter
- 僅引入
my-spring-boot-starter-autoconfigure與所需依賴（如日志庫、Spring Web 等） - 供外部項目使用
2. 編寫自動配置類
@Configuration
@ConditionalOnClass(MyService.class)
@ConditionalOnMissingBean
public class MyServiceAutoConfiguration {@Beanpublic MyService myService() {return new MyService("默認配置");}
}
3. 注冊自動配置類
在 my-spring-boot-starter-autoconfigure 的 resources/META-INF/spring.factories 文件中：
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.autoconfig.MyServiceAutoConfiguration
Spring Boot 2.7 及以后版本推薦使用
META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports。
4. 打包發布
分別將 starter-autoconfigure 和 starter 打成 jar 包，并發布至私服或 Maven 中央庫。
四、整合屬性配置（可選）
為了增強 Starter 的可配置性，可以整合 @ConfigurationProperties。
示例：
@ConfigurationProperties(prefix = "my.service")
public class MyServiceProperties {private String name = "默認名稱";// getter & setter
}@Configuration
@EnableConfigurationProperties(MyServiceProperties.class)
public class MyServiceAutoConfiguration {@Beanpublic MyService myService(MyServiceProperties properties) {return new MyService(properties.getName());}
}
用戶項目中即可通過 application.yml 覆蓋默認配置：
my:service:name: 自定義名稱
五、與 Spring Boot 官方 Starter 的區別
| 官方 Starter | 自定義 Starter |
|---|---|
| 功能強大、通用性廣 | 適用于內部統一配置 |
| 發布在 Maven Central | 可發布至公司私服 |
| 通常有多個子模塊 | 結構自由，便于維護 |
六、結語
Spring Boot Starter 是實現模塊化、自動化配置的關鍵利器。通過本篇內容，我們系統性地理解了 Starter 的構建原理及其核心機制，并掌握了開發一個自定義 Starter 的完整流程。
掌握 Starter 的構建技巧，不僅能提升開發效率，也為你在團隊中構建標準化基礎組件打下堅實基礎。
附：自定義 Starter 項目結構示意
my-spring-boot-starter/
├── my-spring-boot-starter/
│ └── pom.xml (依賴 my-spring-boot-starter-autoconfigure)
└── my-spring-boot-starter-autoconfigure/├── src/main/java/│ └── com/example/autoconfig/│ ├── MyServiceAutoConfiguration.java│ └── MyServiceProperties.java├── src/main/resources/│ └── META-INF/│ └── spring.factories└── pom.xml
