罗罗编程学习记录
本页内容 展开查看

06.2.2.4 Starter 与依赖管理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.2 Java Spring 生态 / 06.2.2 Spring Boot

本节要解决的问题

  • Starter 解决什么问题,官方与自定义 Starter 的命名、模块结构是什么?
  • BOM 如何统一第三方版本,import BOM 与继承 parent 有何区别?
  • 依赖冲突如何定位与收敛,覆盖 BOM 版本有什么风险?

版本前提:Spring Boot 3.x;Maven/Gradle 依赖管理通用概念,版本号以官方 BOM 为准。

06.2.2.4-001 Starter 机制是什么?如何自定义一个 Starter?

一句话结论

Starter 是「依赖聚合 + 自动配置」的打包约定:把某能力所需的库与配置类聚合到一个模块,使用者引入即按条件装配;自定义 Starter 提供 autoconfigure 模块、imports 文件与属性类。

概念解释

官方约定把 starter(只放依赖声明)与 autoconfigure(配置类)拆成两个模块。业务方引入 starter,传递依赖 autoconfigure,容器按条件装配默认 Bean,并通过属性类开放配置。

原理流程

  1. 新建 xxx-spring-boot-autoconfigure:自动配置类、属性类、imports 文件。
  2. 新建 xxx-spring-boot-starter:依赖 autoconfigure 模块。
  3. 自动配置类用条件注解装配 @Bean,@ConditionalOnMissingBean 让位用户实现。
  4. 使用者引入 starter,无需手写配置即可使用默认能力。

示例

my-client-spring-boot-starter/
└── pom.xml  → 依赖 my-client-spring-boot-autoconfigure

my-client-spring-boot-autoconfigure/
├── src/main/java/com/example/autoconfigure/
│   ├── MyClientProperties.java
│   └── MyClientAutoConfiguration.java
└── src/main/resources/META-INF/spring/
    └── org.springframework.boot.autoconfigure.AutoConfiguration.imports

常见误区

  • 把 @Component 扫进 starter:autoconfigure 类靠 imports 注册,不依赖使用者包路径。
  • 自定义 starter 不做条件隔离:缺少关键库时仍注册 Bean,启动期才报类缺失。

追问

  • 自定义 starter 要不要引 spring-boot-starter?autoconfigure 模块通常依赖 spring-boot-autoconfigure 提供条件注解。
  • 如何让用户覆盖默认实现?默认 Bean 标 @ConditionalOnMissingBean,用户提供同类型 Bean 即可替换。

06.2.2.4-002 Spring Boot BOM 版本管理如何理解?

一句话结论

spring-boot-dependencies 通过 dependencyManagement 声明官方验证过的第三方库版本;项目依赖不写版本号,升级 Boot 即整体升级,避免版本错配。

概念解释

BOM(Bill of Materials)是一份只管理版本、不引入实现的 POM。依赖声明省略 version 时从 BOM 取受管版本;BOM 中未受管的库仍需显式版本。

示例

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-dependencies</artifactId>
      <version>3.4.x</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

BOM 具体小版本以官方发布为准,文中不锁定版本号。

常见误区

  • 依赖里手写版本号覆盖 BOM:版本脱离官方兼容矩阵,可能与 Boot 编译的其他库不兼容。
  • 以为 BOM 会把所有库都拉进来:它只管理版本,是否引入由 dependency 决定。

追问

  • 升级 Boot 版本时升什么?BOM 版本即第三方库基线,个别库仍需核对 release notes。
  • BOM 没受管的库怎么办?显式声明版本,并做兼容性验证。

06.2.2.4-003 官方与第三方 Starter 的命名约定是什么?

一句话结论

官方 starter 前缀 spring-boot-starter-<能力>;第三方约定 <能力>-spring-boot-starter,避免与官方命名冲突,便于一眼区分来源。

概念解释

命名约定让依赖坐标可预期:官方模块在 org.springframework.boot 下;社区/公司 starter 在自身 groupId 下,名称以能力名开头。

对比

类型 命名 groupId 示例
官方 spring-boot-starter-data-redis org.springframework.boot
官方 Web spring-boot-starter-web org.springframework.boot
第三方 mybatis-spring-boot-starter org.mybatis.spring.boot
公司内部 pay-spring-boot-starter 内部仓库

常见误区

  • 第三方模块也起名 spring-boot-starter-xxx:既混淆来源,也可能与官方坐标冲突。
  • starter 名称不体现能力:依赖目录可读性差,排查引入来源困难。

追问

  • 命名与自动配置注册有关吗?没有强制关系,但约定降低协作成本。
  • 历史上旧版社区 starter 命名不统一怎么办?核对仓库与版本说明,优先选择维护活跃的坐标。

06.2.2.4-004 Starter 与 autoconfigure 模块为什么拆分?

一句话结论

starter 面向使用者,只做依赖聚合;autoconfigure 面向装配,含配置类与元数据;拆分后使用者可只依赖 autoconfigure 定制装配,也避免 starter 携带无关实现类。

概念解释

拆分是分层解耦:依赖坐标与装配逻辑分离。需要自动配置就引 starter;只要库与配置类、想自定义装配流程时可直接依赖 autoconfigure。

示例

spring-boot-starter-data-redis          使用者入口(聚合依赖)
  └─ spring-boot-data-redis(库)
  └─ spring-boot-autoconfigure(Redis 自动配置所在)

常见误区

  • 在 starter 模块里写配置类:模块职责混乱,使用者想排除自动配置时无法干净分离。
  • 把属性类与配置类放到业务包:应在 autoconfigure 模块内自包含。

追问

  • 简单内部工具能否合并成一个模块?可以,但发布为公共 starter 时建议按约定拆分。
  • autoconfigure 模块能否独立发布?能,使用者直接依赖并自行注册配置。

06.2.2.4-005 自定义 Starter 的标准模块结构包含哪些部分?

一句话结论

包含:自动配置类、属性绑定类、条件注解装配、imports 注册文件、可选元数据 processor;starter 模块只依赖 autoconfigure。

概念解释

一个可发布的 starter 由依赖聚合模块与自动配置模块组成:配置类、属性类、注册文件与元数据放在 autoconfigure 模块,starter 模块只声明对它的依赖。

示例

xxx-spring-boot-autoconfigure/
├── com/example/autoconfigure/
│   ├── XxxProperties.java        @ConfigurationProperties
│   └── XxxAutoConfiguration.java @AutoConfiguration
└── resources/
    ├── META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
    └── META-INF/additional-spring-configuration-metadata.json(可选)

常见误区

  • 缺少 imports 文件:配置类不被选择器读取,Bean 不注册。
  • 属性类未注册:没有 @EnableConfigurationProperties 或扫描,注入报缺 Bean。

追问

  • 配置类依赖其他自动配置如何排序?@AutoConfigureAfter/Before。
  • 如何提供默认值又允许覆盖?@ConditionalOnMissingBean + 属性类默认值。

06.2.2.4-006 configuration-processor 在 Starter 里起什么作用?

一句话结论

编译期扫描属性类生成配置元数据 JSON,IDE 提供键名、类型、默认值与描述提示;starter 随包发布元数据,使用者配置时可补全。

概念解释

configuration-processor 是编译期注解处理器,读取 @ConfigurationProperties 字段生成元数据 JSON;标记 optional 后不进入运行时 classpath。

示例

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-configuration-processor</artifactId>
  <optional>true</optional>
</dependency>

常见误区

  • processor 设为非 optional:被传递进运行时 classpath,增加无用依赖。
  • 属性字段缺少注释:元数据有键名但无描述,体验差。

追问

  • 元数据产物在哪?target/classes/META-INF/spring-configuration-metadata.json,随 jar 发布。
  • 手写元数据文件用什么名?additional-spring-configuration-metadata.json 补充非注解来源的键。

06.2.2.4-007 Starter 默认依赖版本如何继承 BOM?

一句话结论

starter 的依赖不写版本号,由 spring-boot-dependencies BOM 统一受管;starter 自身版本跟随 Boot 发布序列,保证与框架版本兼容。

概念解释

官方 starter 由 Boot 仓库构建,依赖坐标在 BOM 中有受管版本;业务项目引入 starter 后,传递依赖的版本从 BOM 解析,不冲突。

示例

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-data-redis</artifactId>
  <!-- 无需 version -->
</dependency>

常见误区

  • 给 starter 依赖手写旧版本:破坏 BOM 统一基线。
  • 升级 Boot 后手工降级某个 starter:要核对该 starter 与 Boot 的兼容版本。

追问

  • 第三方 starter 的版本谁管?第三方自身发布版本,其依赖版本可能引用对应 Boot BOM,需核对说明。
  • starter 版本与 Boot 版本不一致怎么办?优先使用与当前 Boot 配套的 starter 版本。

06.2.2.4-008 如何排除传递依赖?

一句话结论

在依赖声明中用 exclusions 排除不需要的传递库;排除后需确认没有其他路径带入,避免类重复或冲突。

概念解释

Maven 依赖传递会把间接库带入 classpath;exclusions 在声明依赖处剔除指定传递坐标,避免不需要或冲突的库被引入。

示例

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

常见误区

  • 只排一处路径:另一依赖路径仍带入同一库,类冲突依旧。
  • 排除运行必需的库:容器缺少实现类,启动报类缺失。

追问

  • Gradle 怎么排除?exclude group:..., module:...。
  • 排除后怎么验证?dependency:tree 搜索该坐标是否还存在。

06.2.2.4-009 如何判断项目里引入了哪个 Starter?

一句话结论

用依赖树搜索 starter 坐标与自动配置类来源;配合启动 --debug 条件报告查看生效的自动配置模块,区分是官方 starter、第三方 starter 还是手工依赖。

概念解释

starter 只声明坐标,真正的库与自动配置沿依赖树传递;通过依赖树与条件报告可以区分入口 starter、传递库与手工配置。

示例

mvn dependency:tree | grep starter
gradle dependencies | grep starter

常见误区

  • 只看引入的业务依赖:自动配置可能由传递 starter 带入,需沿依赖树往上找入口。
  • 把库本身当成 starter:如只引 Lettuce 客户端不等同于引入 Redis starter。

追问

  • 某个 Bean 来自哪个模块?在 Bean 名称与自动配置类名上看包名,或调试条件报告。
  • 如何清理无用 starter?依赖树确认无业务代码引用后移除,回归测试覆盖。

06.2.2.4-010 常用官方 Starter 有哪些?分别聚合什么?

一句话结论

按能力分组:Web/HTTP、数据访问、消息队列、缓存、校验、测试、Actuator;每个 starter 聚合对应库与自动配置依赖。

对比

Starter 主要能力
spring-boot-starter-web Spring MVC、Tomcat、JSON 序列化
spring-boot-starter-webflux Reactive 栈、Netty
spring-boot-starter-data-jpa Hibernate、JPA 抽象
spring-boot-starter-jdbc JdbcTemplate、HikariCP
spring-boot-starter-data-redis Redis 客户端与缓存抽象
spring-boot-starter-amqp RabbitMQ
spring-boot-starter-kafka Kafka 客户端
spring-boot-starter-validation Bean Validation
spring-boot-starter-test 测试框架与断言库
spring-boot-starter-actuator 监控端点与指标

常见误区

  • 引 web 又引 webflux:两套栈并存,类型推断与配置冲突,应按架构选一套。
  • 把 starter 当运行时库理解:starter 不含业务逻辑,只聚合依赖与装配。

追问

  • 只需要 JSON 序列化引什么?spring-boot-starter-json 或 web 自带,按需最小化引入。
  • 消息队列 starter 与客户端版本关系?客户端版本由 BOM 受管。

06.2.2.4-011 BOM import 与继承 parent 有何区别?

一句话结论

继承 spring-boot-starter-parent 同时获得版本管理、插件配置与默认打包约定;import BOM 只获得依赖版本管理,构建插件与配置自行负责。

对比

维度 继承 starter-parent import BOM
依赖版本 受管 受管
插件配置 继承默认插件版本 不继承
资源编码/过滤约定 内置 自行配置
多模块顶层绑定 受 parent 约束 更灵活
已有公司 parent 不便双重继承 推荐方式

示例

<!-- 方式一:继承 -->
<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>3.4.x</version>
</parent>

<!-- 方式二:多模块/已有 parent 时 import BOM -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-dependencies</artifactId>
      <version>3.4.x</version>
      <type>pom</type><scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

常见误区

  • 已经继承公司 parent 又想继承 Boot parent:Maven 单 parent,改用 BOM import。
  • import BOM 后期望打包插件自动配置:插件版本仍需自己声明。

追问

  • Gradle 用什么?platform(org.springframework.boot:spring-boot-dependencies)。
  • 哪种方式升级更干净?BOM import 显式管理一个版本坐标,parent 继承同时受插件约定影响。

06.2.2.4-012 依赖版本冲突如何排查与收敛?

一句话结论

dependency:tree -Dverbose 看同一坐标被哪些路径引入与仲裁结果;优先用 BOM 受管版本,必要时 exclusions 排除旧路径,或在 dependencyManagement 统一声明版本。

原理流程

  1. 运行依赖树,搜索冲突坐标与版本差异。
  2. 看 Maven 最近优先/声明顺序仲裁选中的版本。
  3. 判断受管版本是否合适:不合适则排除引入路径或统一受管。
  4. 回归测试验证运行期类行为。

示例

mvn dependency:tree -Dverbose -Dincludes=com.fasterxml.jackson.core

常见误区

  • 看到两个版本就手工锁定高版本:未验证兼容性,可能触发二进制不兼容。
  • 只在一个模块排除:其他模块路径仍带入冲突版本。

追问

  • 仲裁规则是什么?Maven 按路径深度最近优先,同深度按声明顺序;版本冲突不保证功能兼容。
  • 如何统一收敛?在顶层 dependencyManagement 声明受管版本,所有子模块复用。

06.2.2.4-013 覆盖 BOM 受管版本有什么风险?

一句话结论

覆盖后该库脱离 Boot 官方验证基线,可能与框架编译的其他库存在 API 或行为不兼容;必须覆盖时在顶层统一声明并跑集成测试,不零散在模块内覆盖。

概念解释

BOM 版本是框架发布时联合验证过的组合。单独升级或降级某库,可能遇到类签名变化、行为默认值改变、传递依赖不匹配。

常见误区

  • 为修一个漏洞随意升小版本:未回归测试,引入更大风险。
  • 多处模块各自覆盖:版本碎片化,冲突难以追踪。

追问

  • 安全补丁必须升怎么办?优先等官方 BOM 更新;紧急时显式覆盖并记录原因与验证结果。
  • 覆盖后如何验证?依赖树确认版本生效,启动集成测试与关键链路回归。

06.2.2.4-014 多模块项目如何组织依赖管理?

一句话结论

顶层模块用 dependencyManagement 统一 BOM 与公共受管版本;子模块只声明坐标不写版本;公共依赖抽到底层公共模块,避免各模块重复声明。

概念解释

多模块项目把版本与公共依赖收敛到顶层,子模块只声明坐标不写版本;公共能力抽到底层模块复用,避免各模块重复声明与版本漂移。

示例

parent/                 顶层:dependencyManagement + 插件约定
├── common/             公共工具与公共依赖
├── order-service/      业务模块:依赖 common + BOM 受管坐标
└── user-service/

常见误区

  • 每个模块各自引 BOM:版本漂移,升级时多处修改。
  • 业务模块直接引实现库而绕过 common:依赖重复、版本不一致。

追问

  • 子模块要单独版本怎么办?在子模块 dependencyManagement 局部声明,但要记录理由。
  • 公共模块打包为普通 jar 还是 starter?跨服务复用装配用 starter;纯工具库用普通 jar。

06.2.2.4-015 有没有不带自动配置的 Starter?

一句话结论

有:仅做依赖聚合的 starter 或纯库 starter 不提供自动配置;使用者自行写 @Configuration 装配。Boot 官方也有只聚合测试、JSON 等基础依赖的 starter。

概念解释

starter 是打包约定,不强制包含自动配置。当能力需要使用者显式控制装配、或库本身不适合条件化注册时,可以只聚合依赖。

常见误区

  • 期望引入即生效但 starter 不含 autoconfigure:Bean 未注册,需要手工配置类。
  • 把无配置 starter 当成官方装配能力:核对模块内是否有 imports 文件。

追问

  • 如何判断 starter 是否含自动配置?解压 jar 看 META-INF/spring/...AutoConfiguration.imports。
  • 纯库 starter 的使用方式?引依赖 + 自己的配置类注册 Bean。

06.2.2.4-016 第三方 Starter 适配 Boot 3 要注意什么?

一句话结论

检查包名是否迁移到 jakarta.*、自动配置文件是否迁移到 imports、条件注解与 API 是否兼容 Framework 6;未适配的 starter 不要在 Boot 3 项目中引入。

概念解释

Boot 3 对应 Framework 6 与 Jakarta EE 9+ 命名空间。旧 starter 若仍依赖 javax.*、springfox、旧版 security 适配层,会出现类缺失或配置不生效。

常见误区

  • 凭「能编译」判断适配完成:javax 类在运行期类加载才报错。
  • 沿用旧 spring.factories 自动配置键:Boot 3 自动配置需 imports 文件。

追问

  • 哪些常见旧库需要替换?springfox 换 springdoc-openapi;旧 Shiro/MyBatis-Plus 版本需升级到支持 Jakarta 的版本,以各库官方说明为准。
  • 如何静态排查?dependency:tree 搜 javax 坐标,运行测试与 Testcontainers 验证。

06.2.2.4-017 依赖收敛与最小化原则是什么?

一句话结论

只引入当前模块真实使用的能力;优先用能力粒度 starter;定期清理未引用依赖;传递依赖带来的库要能解释来源,避免运行时 classpath 膨胀。

概念解释

classpath 越大,类冲突、安全漏洞、启动扫描成本越高。最小化依赖便于排查冲突、缩小攻击面、加快构建。

常见误区

  • 图方便引全功能 starter:带入不需要的数据库、消息客户端,条件装配虽可跳过但类与资源仍在。
  • 注释掉业务代码却保留依赖:残留依赖不被编译引用,但仍参与打包。

追问

  • 如何发现未使用依赖?IDE 分析、构建插件报告或人工沿 import 核对。
  • 传递依赖要不要显式升级?先确认直接使用的库,再考虑锁定传递版本。

06.2.2.4-018 Spring Cloud 与 Boot 的版本兼容矩阵怎么看?

一句话结论

Spring Cloud 按发布列车与 Boot 版本成对兼容;引入 Cloud 组件前先查官方 Release Notes 兼容表,Cloud BOM 与 Boot BOM 配套使用,不能随意混搭。

概念解释

Cloud 依赖 Framework 与 Boot 的 API 与自动配置,不同发布列车对应不同 Boot 世代。混用不兼容组合会出现自动配置缺失、Bean 类型不匹配。

示例

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-dependencies</artifactId>
      <version>2024.0.x</version>
      <type>pom</type><scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Cloud 版本号与 Boot 兼容关系以官方 Release Notes 为准,文中标注「待确认」处需核对当前支持列表。

常见误区

  • 先选 Boot 版本再随便挑 Cloud:列车版本不匹配,组件自动配置可能失效。
  • 升级 Boot 不同步评估 Cloud:Cloud 组件可能尚未支持新 Boot。

追问

  • 兼容矩阵在哪查?Spring Cloud 官方 Wiki 的 Release Train 表列出对应 Boot 版本。
  • 组件版本谁受管?Cloud BOM 统一管理 Netflix/Alibaba 等组件版本,业务不另写版本号。