如何自定义一个 Spring Boot Starter？

news2025/6/7 12:29:02

导语：
在后端 Java 面试中，Spring Boot 是绕不开的重点，而“如何自定义一个 Starter”作为进阶开发能力的体现，常被面试官用于考察候选人的工程架构思维与 Spring Boot 底层掌握程度。本文将带你深入理解自定义 Starter 的实现逻辑、常见面试题解析及实战场景，助你从容应对技术面试。

一、面试主题概述

在 Spring Boot 中，Starter 是一种模块化、解耦合、可插拔的自动化配置机制，广泛用于封装通用功能（如 Redis、MyBatis、监控组件等），提高开发效率。

自定义 Starter 不仅可以在实际项目中实现中间件的标准封装，还常被面试官作为“进阶考点”用于考察候选人的：

Spring Boot 自动装配理解程度
模块封装能力与扩展思维
对 @Conditional、SPI机制的掌握

若你能流畅讲解并写出一个自定义 Starter，在中高级面试中无疑是一个亮眼加分项。

二、高频面试题汇总

什么是 Spring Boot Starter？为何需要自定义 Starter？
自定义 Starter 需要哪些核心组件？
如何实现自动配置类（AutoConfiguration）？
@Conditional 注解的作用和常见使用方式有哪些？
自定义 Starter 在实际项目中有哪些应用场景？

三、重点题目详解

题目 1：如何自定义一个 Spring Boot Starter？请简述步骤并给出示例代码。

✅ 解题思路

要实现一个自定义 Starter，至少包括两个模块：

starter 模块（仅依赖并暴露 API，无配置逻辑）
autoconfigure 模块（用于自动装配，提供核心实现）

✅ 示例：自定义一个简单的日志增强 Starter

功能：自动打印所有 Controller 方法的入参和出参，统一日志格式。

1. 创建两个模块

log-starter
log-autoconfigure

目录结构如下：

log-starter/
├── pom.xml (依赖 log-autoconfigure)
└── ...

log-autoconfigure/
├── pom.xml
└── src/main/java/com/example/log/autoconfigure/
    ├── LogProperties.java
    ├── LogAspect.java
    └── LogAutoConfiguration.java

2. 核心配置类 LogProperties.java

@ConfigurationProperties(prefix = "custom.log")
public class LogProperties {
    private boolean enable = true;

    public boolean isEnable() {
        return enable;
    }

    public void setEnable(boolean enable) {
        this.enable = enable;
    }
}

3. 切面实现 LogAspect.java

@Aspect
public class LogAspect {

    @Around("execution(* com.example..controller..*(..))")
    public Object log(ProceedingJoinPoint joinPoint) throws Throwable {
        String method = joinPoint.getSignature().toShortString();
        Object[] args = joinPoint.getArgs();
        System.out.println("【入参】" + method + " 参数：" + Arrays.toString(args));

        Object result = joinPoint.proceed();

        System.out.println("【出参】" + method + " 返回：" + result);
        return result;
    }
}

4. 自动配置类 LogAutoConfiguration.java

@Configuration
@ConditionalOnProperty(prefix = "custom.log", name = "enable", havingValue = "true")
@EnableConfigurationProperties(LogProperties.class)
public class LogAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public LogAspect logAspect() {
        return new LogAspect();
    }
}

5. 添加 SPI 文件

在 log-autoconfigure 中创建：

resources/META-INF/spring.factories

内容如下：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.log.autoconfigure.LogAutoConfiguration

6. 父模块引用

log-starter 只需要打包并依赖 log-autoconfigure：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>log-autoconfigure</artifactId>
</dependency>

✅ 面试官角度分析

考察点：

模块拆分能力（starter vs autoconfigure）
Spring Boot 自动配置核心机制
条件装配与扩展性（@Conditional）
工程规范意识与可插拔设计思维

加分点：

能主动提及 SPI 与 spring.factories 文件
能结合实际业务场景谈应用，如统一日志、数据脱敏、慢 SQL 监控等

题目 2：@ConditionalOnProperty 和 @ConditionalOnMissingBean 有何作用？如何配合使用？

✅ 解题要点

@ConditionalOnProperty：根据配置文件中的开关（如 custom.log.enable）决定是否注入某个 Bean。
@ConditionalOnMissingBean：避免重复注入，只有当上下文中没有某个类型的 Bean 时才会生效。

实际应用中通常“组合使用”，确保配置可控、注入安全，符合 Spring Boot“默认可用、可配置”的设计理念。

四、面试官视角与加分项

维度	面试官常观察点	如何打动面试官
技术深度	是否了解 @EnableAutoConfiguration 背后的 SPI 机制	提及 `spring.factories` 自动加载机制，理解其作用
实战能力	是否能从实际项目出发，自主封装模块	分享你自定义过的 Starter，如日志/Redis/MyBatis拦截器等
代码规范	模块结构是否清晰、Bean 配置是否优雅	遵守 starter-autoconfigure 分层，注重注释与命名规范
延展思维	是否考虑过跨团队复用、版本兼容	谈及在微服务或中台架构中的封装经验更具说服力