如何自定义一个Spring Boot Starter？-java教程-PHP中文网

如何自定义一个Spring Boot Starter？

紅蓮之龍

发布： 2025-09-03 22:45:01

原创

478人浏览过

自定义Spring Boot Starter需创建自动配置类和属性类，通过条件注解控制Bean加载，使用spring.factories注册配置，避免依赖、Bean名和加载顺序冲突，并通过测试验证功能。

如何自定义一个spring boot starter？

自定义Spring Boot Starter，简单来说，就是把一系列配置和依赖打包成一个可重用的模块，方便其他项目快速集成某个功能。核心在于自动配置，让 Spring Boot 能够自动发现并应用你的配置。

创建一个自定义 Spring Boot Starter，需要以下步骤：

定义自动配置类

自动配置类是 Starter 的核心，它负责根据条件自动配置 Bean。

创建配置类: 创建一个带有
```
@Configuration
```
登录后复制
注解的类，用于定义 Bean。
使用条件注解: 使用
```
@ConditionalOnClass
```
登录后复制
,
```
@ConditionalOnMissingBean
```
登录后复制
,
```
@ConditionalOnProperty
```
登录后复制
等条件注解，控制 Bean 的创建。例如，只有当 classpath 中存在某个类时才创建 Bean。
配置属性绑定: 使用
```
@EnableConfigurationProperties
```
登录后复制
注解启用配置属性类，将配置文件中的属性绑定到 Java 对象上。
自动配置生效: 使用
```
@AutoConfigureAfter
```
登录后复制
或
```
@AutoConfigureBefore
```
登录后复制
控制自动配置类的加载顺序，确保依赖的 Bean 已经创建。

一个简单的例子：

@Configuration
@ConditionalOnClass(MyService.class)
@EnableConfigurationProperties(MyServiceProperties.class)
public class MyServiceAutoConfiguration {

    @Autowired
    private MyServiceProperties properties;

    @Bean
    @ConditionalOnMissingBean
    public MyService myService() {
        return new MyService(properties.getMessage());
    }
}

登录后复制

创建配置属性类

配置属性类用于定义可以从

application.properties

登录后复制

或

application.yml

登录后复制

中配置的属性。

创建属性类: 创建一个带有
```
@ConfigurationProperties
```
登录后复制
注解的类，指定属性的前缀。
定义属性: 定义与配置文件中的属性对应的字段，并提供 getter 和 setter 方法。

例如：

@ConfigurationProperties("my.service")
public class MyServiceProperties {

    private String message = "Hello, World!";

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }
}

登录后复制

创建 Starter 项目

创建 Maven 项目: 创建一个 Maven 项目，并添加必要的依赖，例如
```
spring-boot-autoconfigure
```
登录后复制
和
```
spring-boot-configuration-processor
```
登录后复制
。
```
spring-boot-configuration-processor
```
登录后复制
用于在编译时生成配置元数据，方便 IDE 自动提示。
打包方式: 将打包方式设置为
```
jar
```
登录后复制
。
目录结构: 确保目录结构正确，自动配置类放在
```
src/main/java
```
登录后复制
目录下，配置文件放在
```
src/main/resources/META-INF/spring.factories
```
登录后复制
中。

注册自动配置类

在

src/main/resources/META-INF/spring.factories

登录后复制

文件中注册自动配置类。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.MyServiceAutoConfiguration

登录后复制

发布 Starter

本地安装: 使用
```
mvn install
```
登录后复制
命令将 Starter 安装到本地 Maven 仓库。
发布到 Maven 中央仓库: 如果要发布到 Maven 中央仓库，需要配置 Maven 的
```
settings.xml
```
登录后复制
文件，并使用
```
mvn deploy
```
登录后复制
命令发布。

如何避免Starter之间的冲突？

Starter 之间的冲突，通常是由于依赖版本冲突、Bean 名称冲突或者自动配置顺序冲突引起的。

依赖版本冲突:

通义万相

通义万相，一个不断进化的AI艺术创作大模型

596

查看详情

统一依赖版本: 尽可能统一各个 Starter 依赖的版本。可以使用 Spring Boot 的 Dependency Management 来管理依赖版本。
排除冲突依赖: 如果无法统一版本，可以使用 Maven 的
```
<exclusions>
```
登录后复制
标签排除冲突的依赖。

Bean 名称冲突:

自定义 Bean 名称: 使用
```
@Bean
```
登录后复制
注解时，显式指定 Bean 的名称，避免使用默认名称。
使用条件注解: 使用
```
@ConditionalOnMissingBean
```
登录后复制
注解，只有当容器中不存在同名 Bean 时才创建 Bean。

自动配置顺序冲突:

使用
@AutoConfigureAfter
登录后复制
和
@AutoConfigureBefore
登录后复制
: 控制自动配置类的加载顺序，确保依赖的 Bean 已经创建。
避免循环依赖: 避免自动配置类之间存在循环依赖关系。

除了以上方法，还可以考虑使用 Spring Boot 的

spring.autoconfigure.exclude

登录后复制

属性，在应用程序中排除不需要的自动配置类。

如何测试自定义 Spring Boot Starter？

测试自定义 Spring Boot Starter，可以验证其是否能够正确地自动配置 Bean，以及配置属性是否能够生效。

创建测试项目: 创建一个新的 Spring Boot 项目，并添加自定义 Starter 的依赖。
编写测试用例: 使用 JUnit 和 Spring Test 编写测试用例，验证 Bean 是否被正确创建，以及配置属性是否生效。

例如：

@RunWith(SpringRunner.class)
@SpringBootTest
public class MyServiceAutoConfigurationTest {

    @Autowired
    private MyService myService;

    @Value("${my.service.message}")
    private String message;

    @Test
    public void testMyService() {
        assertNotNull(myService);
        assertEquals(message, myService.getMessage());
    }
}

登录后复制

如何选择合适的条件注解？

选择合适的条件注解，是确保自动配置类能够正确生效的关键。

```
@ConditionalOnClass
```
登录后复制
: 当 classpath 中存在指定的类时，才会创建 Bean。适用于依赖特定类库的场景。
```
@ConditionalOnMissingBean
```
登录后复制
: 当容器中不存在指定名称或类型的 Bean 时，才会创建 Bean。适用于提供默认 Bean 的场景。
```
@ConditionalOnProperty
```
登录后复制
: 当配置文件中存在指定的属性，且属性值为指定值时，才会创建 Bean。适用于根据配置属性控制 Bean 的创建的场景。
```
@ConditionalOnResource
```
登录后复制
: 当 classpath 中存在指定的资源时，才会创建 Bean。适用于依赖特定资源的场景。
```
@ConditionalOnWebApplication
```
登录后复制
: 当应用是 Web 应用时，才会创建 Bean。适用于只在 Web 应用中生效的场景。
```
@ConditionalOnNotWebApplication
```
登录后复制
: 当应用不是 Web 应用时，才会创建 Bean。适用于只在非 Web 应用中生效的场景。