用户58856854055的头像[特殊字符]Spring Boot 多模块项目中 Parent / BOM / Starter 的正确分工

🍃Spring Boot 多模块项目中 Parent / BOM / Starter 的正确分工


🎯 结论先行(只记这三条)

✅ Parent:继承规则 (构建规范、插件、依赖管理)

✅ BOM(dependencyManagement):只管版本,不引包

✅ Starter(dependency):真正引入功能


🧱 1️⃣ Parent 是干什么的?

📌 Parent ≠ 引入依赖

Parent 的职责只有这些:

  • 🧩 统一依赖版本策略(通过 dependencyManagement)
  • 🔧 统一插件配置(compiler / surefire / boot plugin)
  • 📐 统一构建规范(Java 版本、编码、profile)

👉 Parent 是"规则继承",不是"功能引入"。


📘 2️⃣ dependencyManagement 是不是"引入依赖"?

❌ 不是

复制代码
xml

<dependencyManagement>

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-dependencies</artifactId>

<version>4.0.1</version>

<type>pom</type>

<scope>import</scope>

</dependency>

</dependencyManagement>

这段配置的真实含义是:

🧾 引入 Spring Boot 4.0.1 的"版本清单(BOM)"

它只做:

  • ✅ 管理 Spring Boot 相关依赖的版本

它不会:

  • ❌ 引入任何 jar
  • ❌ 启用任何 Spring Boot 功能

👉 只管版本,不进 classpath。


📦 3️⃣ 那 Spring Boot 功能是怎么来的?

来自 Starter 👇

复制代码
xml

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

效果:

  • 🌐 Spring MVC
  • 🚀 内嵌 Web Server(Tomcat / Jetty)
  • 🔁 自动配置

👉 Starter 才是真正"引包 + 启功能"的地方。


🏗 4️⃣ 多模块项目的正确结构

父 POM(A)

复制代码
xml

<dependencyManagement>

<dependencies>

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-dependencies</artifactId>

<version>4.0.1</version>

<type>pom</type>

<scope>import</scope>

</dependency>

</dependencies>

</dependencyManagement>

作用:

  • 🔒 锁定 Spring Boot 版本
  • 📏 统一所有子模块的依赖版本

子模块(A1 / A2 / A3)

复制代码
xml

<parent>

<groupId>com.mycompany</groupId>

<artifactId>A</artifactId>

<version>1.0.0</version>

</parent>

<dependencies>

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

</dependencies>

效果:

  • ✅ 自动使用 Spring Boot 4.0.1 的版本组合
  • ✅ Web 服务可直接启动
  • ❌ 不需要继承 spring-boot-starter-parent

🧠 5️⃣ 一句话总结(工程版)

父 POM 用 BOM 定版本,子模块用 Starter 启功能。

或者:

dependencyManagement 管"用哪个版本",dependency 管"用不用这个功能"。


🧩 6️⃣ build / plugin 是否需要在子模块再写?

这是多模块项目里第二容易踩坑的问题。

🎯 先给结论

父 POM 里的插件配置,子模块一定会继承;是否需要再写一遍,取决于插件写在 plugins 还是 pluginManagement。


🟢 情况一:父 POM 写在 pluginManagement(✅ 推荐)

复制代码
xml

<build>

<pluginManagement>

<plugins>

<plugin>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-maven-plugin</artifactId>

<version>4.0.1</version>

</plugin>

</plugins>

</pluginManagement>

</build>

含义:

  • 🧩 只定义 插件版本和规则
  • ❌ 不会自动执行插件
  • ✅ 子模块 需要用时再声明(不用写 version)

子模块写法:

复制代码
xml

<build>

<plugins>

<plugin>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-maven-plugin</artifactId>

</plugin>

</plugins>

</build>

👉 这是最安全、最可控、最推荐的方式。


🔴 情况二:父 POM 写在 plugins(⚠️ 谨慎)

复制代码
xml

<build>

<plugins>

<plugin>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-maven-plugin</artifactId>

<version>4.0.1</version>

</plugin>

</plugins>

</build>

含义:

  • ⚠️ 插件会 自动作用到所有子模块
  • ❌ 包括不该打包成 Boot 应用的模块(common / api / model)

👉 容易导致"全家一起 repackage"的事故。


📊 一眼对照表

|------------------|-----------|-----------------|-------|
| 父 POM 放置位置 | 子模块是否继承配置 | 子模块是否要再写 | 是否推荐 |
| pluginManagement | ✅ 是 | ✅ 要(不写 version) | ⭐⭐⭐⭐⭐ |
| plugins | ✅ 是 | ❌ 不用 | ⚠️ |


🧠 7️⃣ 最终总结(全篇核心)

dependencyManagement 决定"版本用哪个",

dependency 决定"功能要不要",

pluginManagement 决定"插件怎么用",

plugins 决定"插件是否执行"。


📌 最终结论

✅ 父 POM import Spring Boot BOM ------ 只做版本管理

✅ 子模块继承父 POM ------ 自动获得版本与插件规则

✅ 子模块依赖 starter ------ Spring Boot 功能生效

✅ 插件推荐放在 pluginManagement ------ 子模块按需启用

❌ 不需要、也不应该再继承 Spring Boot parent


🟢 这是 Spring Boot 3 / 4 + Maven 多模块项目的推荐实践。

原文链接:https://juejin.cn/post/7593943464053915658

相关推荐
wangbing112523 分钟前
平台介绍-modbus设备调试
java
starzy199028 分钟前
Scala类和对象:从构造器到样例类的完整指南
开发语言·后端·scala
梦影_35 分钟前
MySQL进阶教程(五)—— SQL调优(下)
android·大数据·数据库·后端·sql·mysql·database
考虑考虑36 分钟前
mariadb数据库
数据库·后端·mariadb
西索斯coding1 小时前
gpt-image-2.5-sunburst 和 gemini-3.1-flash-image 差多少?60 组项目素材的成功成本评测框架
java·linux·gpt·ai
明月_清风1 小时前
用自然语言操控真机:Google Artemis 移动端 AI Agent 上手与实践
人工智能·后端
怪我冷i1 小时前
Rust 的impl语法详解
开发语言·后端·rust
wuminyu1 小时前
Java字节码学习总结:字节码如何加载、解析和执行
java·linux·c语言·jvm·c++
Flynn Liang2 小时前
大模型怎么自己调函数?Spring AI 2.0 Tool Calling 自动循环原理 + 完整时序图
java·人工智能·spring·agent·函数调用·springai·toolcalling
我就是全世界2 小时前
OpenCode Go 套餐划算吗:先看你用哪个模型
开发语言·后端·golang