Spring Boot 启动器（Starter）详解：依赖组合的标准模式

Spring Boot 启动器（Starter）详解：依赖组合的标准模式

一、启动器是什么？

启动器是 Spring Boot 提供的一种依赖描述符，它将某个特定功能所需的所有依赖组合打包，你只需要引入这一个依赖，就能获得该功能的完整支持。

比如你想开发一个 Web 项目，传统方式需要手动引入 spring-webmvc、jackson-databind、tomcat-embed 等多个依赖，还要确保它们的版本互相兼容。引入 spring-boot-starter-web 后，这一个依赖包含了 Web 开发需要的全部依赖组合。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

从 Maven 的角度看，启动器是一个普通的 jar 类型依赖，但它本身几乎不包含业务代码。它的 META-INF 下没有 class 文件，只有一些配置元数据。它的作用是"拉依赖"------通过自身的 pom.xml 中的 <dependencies> 把相关的功能模块打包成一个整体引入。这正是启动器机制的核心：依赖传递。

二、为什么要设计启动器？

在 Spring Boot 出现之前，Spring 项目整合第三方框架需要手动引入多个依赖并人工验证版本兼容性。每引入一个功能，开发者必须自己判断需要哪些依赖、哪些版本能一起工作。版本选错了，编译能过，运行时 NoSuchMethodError。

Spring Boot 的设计团队把所有常用功能所需的依赖组合和版本经过充分测试后固化下来，形成一个个 starter。引入一个 starter 等于引入了一组经过兼容性验证的依赖集合。开发者不需要再关心"引入 MyBatis 还需要哪些依赖"这种问题，MyBatis Spring Boot Starter 已经帮你锁定了 mybatis、mybatis-spring、spring-jdbc 等依赖的合适版本。

三、一个 Starter 的内部结构

以 spring-boot-starter-web 为例，它的 pom.xml 核心内容：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
    </dependency>
    <!-- 其他依赖 -->
</dependencies>

这个依赖列表反映了一个事实：Web 功能 = Spring MVC + 内嵌 Tomcat + Jackson（JSON 序列化）+ Spring 核心。spring-boot-starter 是基础 Starter，提供了 Spring 上下文、日志、配置文件解析等能力，几乎所有其他 Starter 都依赖它。

spring-boot-starter-tomcat 是另一个专门提供内嵌 Tomcat 的 Starter，它被 spring-boot-starter-web 依赖，但如果你需要替换成 Jetty 或 Undertow，可以排除 spring-boot-starter-tomcat，引入对应的 Jetty Starter 或 Undertow Starter。

3.1 Starter 的分类

Spring Boot 官方 Starter 的命名模式是 spring-boot-starter-*，第三方 Starter 建议命名为 *-spring-boot-starter。常见的 Starter 如下：

Web 相关：

• spring-boot-starter-web：基于 Tomcat + Spring MVC 的 Web 开发
• spring-boot-starter-webflux：响应式 Web 开发
• spring-boot-starter-websocket：WebSocket 支持

数据访问：

• spring-boot-starter-data-jpa：Spring Data JPA + Hibernate
• spring-boot-starter-data-redis：Redis 客户端（Lettuce）
• mybatis-spring-boot-starter：MyBatis 整合（第三方）

安全与认证：

• spring-boot-starter-security：Spring Security 核心
• spring-boot-starter-oauth2-client：OAuth2 客户端

消息队列：

• spring-boot-starter-amqp：RabbitMQ
• spring-boot-starter-kafka：Kafka

其他常用：

• spring-boot-starter-mail：邮件发送
• spring-boot-starter-cache：缓存抽象（配合 Caffeine 或 Redis）
• spring-boot-starter-validation：Bean Validation（Hibernate Validator）
• spring-boot-starter-actuator：监控与健康检查
• spring-boot-starter-test：测试依赖集合（JUnit、Mockito、AssertJ 等）

四、启动器与自动配置的关系

启动器是依赖层面 的概念，自动配置是代码层面的概念。两者共同构成了 Spring Boot 的体验。

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

当 @EnableAutoConfiguration 执行时，它会加载 META-INF/spring.factories（Spring Boot 2.7 之前）或 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports（Spring Boot 2.7 之后）中声明的自动配置类。这些自动配置类上有 @ConditionalOnClass 注解，检查 classpath 中是否存在某个类，以此来决定是否生效。

引入 spring-boot-starter-web 时，tomcat-embed-core 被间接引入。ServletWebServerFactoryAutoConfiguration 检测到 classpath 中有 Servlet 类，条件成立，创建 TomcatServletWebServerFactory。DispatcherServletAutoConfiguration 检测到 DispatcherServlet 的 classpath 存在，创建 DispatcherServlet。

启动器引入依赖，依赖的存在使自动配置的条件生效，自动配置产生对应的 Bean。启动器 + 自动配置的组合是 Spring Boot 降低配置成本的实现手段。

五、Starter 的版本管理

官方 Starter 的版本号与 Spring Boot 版本号保持一致。引入 spring-boot-starter-parent 后，所有官方 Starter 都不需要指定版本号，由父 POM 的 dependencyManagement 统一锁定。第三方 Starter 的版本号需要单独管理：

<properties>
    <mybatis-spring-boot.version>2.2.2</mybatis-spring-boot.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>${mybatis-spring-boot.version}</version>
    </dependency>
</dependencies>

官方 Starter 中，spring-boot-starter 是所有其他 Starter 的底层依赖，它引入了 Spring 核心、日志（Logback）、SnakeYAML（解析 yml）等基础组件。spring-boot-starter-test 是唯一在 <scope>test</scope> 下引入的 Starter，只在测试阶段生效。

六、自定义 Starter 的核心要素

当一个内部公共模块被多个微服务使用时，把它封装成一个 Starter 可以统一版本和管理，减少每个服务维护相同配置的重复劳动。自定义 Starter 的要点包括：

1. pom.xml 中定义必要的依赖
2. @Configuration 类中定义自动配置
3. spring.factories 或 AutoConfiguration.imports 中声明配置类
4. spring-configuration-metadata.json 提供配置提示
5. 可选的 @ConditionalOnMissingBean 允许业务模块覆盖默认配置

七、Maven 依赖传递的最佳实践

Starter 机制依赖 Maven 的传递依赖特性，而传递依赖带来了依赖冲突的风险。Spring Boot 通过 BOM 锁定了所有官方 Starter 内部的依赖版本，但对业务模块中的依赖传递仍需要关注。spring-boot-starter-test 在 <scope>test</scope> 下引入，不会传递到生产环境。spring-boot-starter 是默认 compile 范围，会传递到所有子模块，因此确保所有业务模块都通过 spring-boot-dependencies 统一版本。启用 maven-dependency-plugin 分析依赖树，能帮助识别传递依赖中版本冲突的风险点。