Spring Boot Maven 依赖与插件管理:从 Parent 到 BOM 的完整机制

新建 Spring Boot 项目时,发现 Maven 依赖配置存在多个相似概念,产生研究的兴趣。

一、Maven 基础机制

1.1 Maven 依赖分类

Maven 依赖按 packaging 类型分为两大类:

代码包 (有 .class 文件):

packaging	全称	产物	使用场景	示例
jar	Java Archive	.jar	普通代码库、工具类	spring-core, commons-lang3
war	Web Application Archive	.war	Web 应用,部署到 Tomcat	my-webapp
ear	Enterprise Application Archive	.ear	J2EE 企业应用	my-enterprise

构建描述文件 (没有代码):

类型	packaging	特征	作用	示例
聚合 POM	pom	有 `<modules>`	管理多个子模块	多模块父项目
父 POM	pom	有 `<dependencyManagement>` + `<pluginManagement>`	子模块继承配置	spring-boot-starter-parent
BOM	pom	只有 `<dependencyManagement>`	纯版本字典	spring-boot-dependencies
Starter POM	pom	有 `<dependencies>`	依赖集合的”便利包”	spring-boot-starter-web

快速判断方法:

1
看本地仓库 ~/.m2/repository/:
2
├── xxx-1.0.0.jar  → 代码包
3
├── xxx-1.0.0.war  → Web 应用
4
└── xxx-1.0.0.pom  → 构建描述文件 (无代码)

1.2 parent 标签 (继承机制)

作用: 让当前 POM 继承另一个 POM 的配置

公式:

1
parent = 继承配置
2
├── 继承依赖版本 (dependencyManagement)
3
├── 继承插件配置 (pluginManagement)
4
├── 继承属性定义 (properties)
5
└── 继承其他配置

示例:

1
<parent>
2
    <groupId>org.springframework.boot</groupId>
3
    <artifactId>spring-boot-starter-parent</artifactId>
4
    <version>3.2.0</version>
5
</parent>

限制: Maven 单继承,一个 POM 只能有一个 <parent>

1.3 dependencyManagement 标签 (版本管理)

作用: 声明依赖版本号,但不引入依赖

公式:

1
dependencyManagement = 菜单 (声明版本号,不引入)
2
dependencies = 点菜 (真正引入 jar 包)

区别:

特性	dependencyManagement	dependencies
作用	声明版本号	真正引入依赖
下载 jar	❌ 不下载	✅ 下载
类比	餐厅菜单	向服务员点菜

示例:

1
<dependencyManagement>
2
    <dependencies>
3
        <!-- 声明版本: spring-boot-starter-web 使用 3.2.0 -->
4
        <dependency>
5
            <groupId>org.springframework.boot</groupId>
6
            <artifactId>spring-boot-starter-web</artifactId>
7
            <version>3.2.0</version>
8
        </dependency>
9
    </dependencies>
10
</dependencyManagement>
11

12
<dependencies>
13
    <!-- 真正引入: 无需写版本号,继承上面的 3.2.0 -->
14
    <dependency>
15
        <groupId>org.springframework.boot</groupId>
3 collapsed lines
16
        <artifactId>spring-boot-starter-web</artifactId>
17
    </dependency>
18
</dependencies>

1.4 pluginManagement 标签 (插件管理)

作用: 声明插件版本和配置,但不执行插件

公式:

1
pluginManagement = 插件菜单 (声明版本和配置)
2
plugins = 引入插件 (真正执行)

区别:

特性	pluginManagement	plugins
作用	声明插件版本和配置	真正引入并执行插件
执行插件	❌ 不执行	✅ 执行
使用位置	通常在父 POM	子 POM 继承或独立使用

示例:

1
<!-- 父 POM -->
2
<build>
3
    <pluginManagement>
4
        <plugins>
5
            <plugin>
6
                <groupId>org.apache.maven.plugins</groupId>
7
                <artifactId>maven-compiler-plugin</artifactId>
8
                <version>3.11.0</version>
9
                <configuration>
10
                    <source>17</source>
11
                    <target>17</target>
12
                </configuration>
13
            </plugin>
14
        </plugins>
15
    </pluginManagement>
12 collapsed lines
16
</build>
17

18
<!-- 子 POM -->
19
<build>
20
    <plugins>
21
        <plugin>
22
            <groupId>org.apache.maven.plugins</groupId>
23
            <artifactId>maven-compiler-plugin</artifactId>
24
            <!-- 无需写 version 和 configuration,继承父 POM -->
25
        </plugin>
26
    </plugins>
27
</build>

1.5 三个核心标签对比

管理对象对比:

标签	管理对象	作用	Maven 单继承限制
`<parent>`	整个 POM	继承所有配置	只能有一个
`<dependencyManagement>`	依赖版本	声明版本号	可导入多个 BOM
`<pluginManagement>`	插件	声明插件配置	可定义多个

使用场景对比:

场景	parent	dependencyManagement	pluginManagement
继承父项目配置	✅	-	-
统一依赖版本	✅ (通过继承)	✅ (通过 import)	-
统一插件配置	✅ (通过继承)	-	✅ (通过继承)
多 BOM 共存	❌ (单继承)	✅ (import scope)	-

二、Spring Boot 核心概念

2.1 spring-boot-starter-parent vs spring-boot-starter

公式:

1
spring-boot-starter-parent = 规则书(无代码)
2
spring-boot-starter = 地基(核心代码集合)
3
spring-boot-starter-web = 地基 + 房子(Web能力)

真相: Parent 的继承链

1
你的项目
2
    ↓ 继承
3
spring-boot-starter-parent
4
    ↓ 继承
5
spring-boot-dependencies (BOM)
6
    (提供 500+ 依赖的版本号)

关键洞察:

spring-boot-starter-parent 本身继承自 spring-boot-dependencies。所以当你使用 Parent 时:

不需要再引入 spring-boot-dependencies
Parent 已经通过继承获得了 BOM 的所有版本定义
Parent 在 BOM 之上额外添加了插件配置

本质区别:

spring-boot-starter-parent
- 定位: 父工程 POM
- 职责: 版本管理 + 默认配置 + 插件管理
- 特征: 不包含任何代码 jar 包
- 作用: 继承 spring-boot-dependencies 获得版本管理,再配置插件和构建默认值
spring-boot-starter
- 定位: 核心启动器
- 职责: 提供最基础的代码集合
- 内容: Spring Core + AutoConfigure + Logging + YAML 解析
- 适用: 非 Web 应用(定时任务、纯后台服务)
spring-boot-starter-web
- 定位: Web 启动器
- 内容: 包含 spring-boot-starter + Tomcat + Spring MVC + Jackson
- 适用: API 接口、Web 应用

使用关系:

1
有了 Parent,必须引入至少一个 Starter
2
├─ Web 项目: 引入 spring-boot-starter-web (已包含 starter,无需再引)
3
└─ 非 Web 项目: 引入 spring-boot-starter

三、Maven 插件机制

3.1 插件标签结构

Maven 通过 <build><plugins> 配置构建行为:

1
<build>
2
    <plugins>
3
        <plugin>
4
            <groupId>org.apache.maven.plugins</groupId>
5
            <artifactId>maven-compiler-plugin</artifactId>
6
            <version>3.11.0</version>
7
            <configuration>
8
                <!-- 插件配置参数 -->
9
            </configuration>
10
            <executions>
11
                <execution>
12
                    <id>default-compile</id>
13
                    <phase>compile</phase>
14
                    <goals>
15
                        <goal>compile</goal>
6 collapsed lines
16
                    </goals>
17
                </execution>
18
            </executions>
19
        </plugin>
20
    </plugins>
21
</build>

核心标签含义:

<plugins>: 插件列表,真正引入并执行插件
<pluginManagement>: 插件管理,声明版本和配置,类似 dependencyManagement
<version>: 插件版本号
<configuration>: 插件参数配置
<executions>: 绑定插件目标到 Maven 生命周期阶段
<phase>: 生命周期阶段(validate/compile/test/package/install/deploy)
<goals>: 插件目标(如 compile/test/jar/repackage)

插件分类:

1
Build Plugins (构建插件)
2
├── 编译期: maven-compiler-plugin, maven-resources-plugin
3
├── 测试期: maven-surefire-plugin, maven-failsafe-plugin
4
├── 打包期: maven-jar-plugin, maven-war-plugin
5
└── 部署期: maven-deploy-plugin
6

7
Reporting Plugins (报告插件)
8
├── maven-javadoc-plugin
9
├── maven-checkstyle-plugin
10
└── maven-pmd-plugin

3.2 生命周期与插件绑定

Maven 构建生命周期:

1
clean 生命周期:
2
    pre-clean → clean → post-clean
3

4
default 生命周期 (构建核心):
5
    validate → compile → test → package → install → deploy
6
       ↑         ↑       ↑       ↑        ↑        ↑
7
       |         |       |       |        |        |
8
     验证项目    编译    测试     打包      安装     部署
9

10
site 生命周期:
11
    pre-site → site → post-site → site-deploy

默认插件绑定:

生命周期阶段	绑定插件	插件目标
compile	maven-compiler-plugin	compile
test	maven-surefire-plugin	test
package	maven-jar-plugin	jar
install	maven-install-plugin	install
deploy	maven-deploy-plugin	deploy

3.3 pluginManagement vs plugins

公式:

1
pluginManagement = 插件菜单(声明版本和配置)
2
plugins = 引入插件(真正执行)

区别:

<pluginManagement>
- 声明插件版本和默认配置
- 不执行插件
- 通常在父 POM 中定义
<plugins>
- 真正引入并执行插件
- 可继承 pluginManagement 的配置

示例:

1
<!-- 父 POM: pluginManagement -->
2
<build>
3
    <pluginManagement>
4
        <plugins>
5
            <plugin>
6
                <groupId>org.apache.maven.plugins</groupId>
7
                <artifactId>maven-compiler-plugin</artifactId>
8
                <version>3.11.0</version>
9
                <configuration>
10
                    <source>17</source>
11
                    <target>17</target>
12
                </configuration>
13
            </plugin>
14
        </plugins>
15
    </pluginManagement>
12 collapsed lines
16
</build>
17

18
<!-- 子 POM: plugins -->
19
<build>
20
    <plugins>
21
        <plugin>
22
            <groupId>org.apache.maven.plugins</groupId>
23
            <artifactId>maven-compiler-plugin</artifactId>
24
            <!-- 无需写 version 和 configuration,继承父 POM -->
25
        </plugin>
26
    </plugins>
27
</build>

3.4 maven-compiler-plugin (编译插件)

作用:

将 .java 源文件编译成 .class 字节码
绑定到 compile 阶段

核心参数:

1
<plugin>
2
    <groupId>org.apache.maven.plugins</groupId>
3
    <artifactId>maven-compiler-plugin</artifactId>
4
    <version>3.11.0</version>
5
    <configuration>
6
        <!-- 编译目标版本 -->
7
        <source>17</source>
8
        <target>17</target>
9

10
        <!-- JDK 9+ 可用,替代 source/target -->
11
        <release>17</release>
12

13
        <!-- 编译编码 -->
14
        <encoding>UTF-8</encoding>
15

7 collapsed lines
16
        <!-- 编译器参数 -->
17
        <compilerArgs>
18
            <arg>-parameters</arg>  <!-- 保留方法参数名(反射可用) -->
19
            <arg>-Xlint:unchecked</arg>
20
        </compilerArgs>
21
    </configuration>
22
</plugin>

使用场景:

指定 Java 版本(如 Java 17)
保留方法参数名(Spring MVC 等框架需要)
自定义编译器选项

3.5 spring-boot-maven-plugin (Spring Boot 打包插件)

作用:

将普通 JAR 重新打包成可执行 Fat JAR
核心目标: repackage,绑定到 package 阶段

工作流程:

1
1. mvn package 执行
2
   ↓
3
2. 生成普通 JAR (不含依赖)
4
   ↓
5
3. repackage 目标执行
6
   ↓
7
4. 原始 JAR 重命名为 xxx.original
8
   ↓
9
5. 创建新的 Fat JAR:
10
   - BOOT-INF/classes: 你的代码
11
   - BOOT-INF/lib: 所有依赖 jar
12
   - org.springframework.boot.loader: 启动加载器

Fat JAR 结构:

1
my-app.jar
2
├── META-INF/
3
│   └── MANIFEST.MF           # 主类: org.springframework.boot.loader.JarLauncher
4
├── org/springframework/boot/loader/  # 类加载器
5
├── BOOT-INF/
6
│   ├── classes/              # 你的 .class 文件
7
│   └── lib/                  # 依赖的第三方 jar
8
│       ├── spring-core.jar
9
│       ├── jackson-databind.jar
10
│       └── ...

配置示例:

1
<plugin>
2
    <groupId>org.springframework.boot</groupId>
3
    <artifactId>spring-boot-maven-plugin</artifactId>
4
    <configuration>
5
        <!-- 指定主类(通常自动检测) -->
6
        <mainClass>com.example.Application</mainClass>
7

8
        <!-- 排除某些依赖 -->
9
        <excludes>
10
            <exclude>
11
                <groupId>org.projectlombok</groupId>
12
                <artifactId>lombok</artifactId>
13
            </exclude>
14
        </excludes>
15

15 collapsed lines
16
        <!-- 可执行 jar 归档器配置 -->
17
        <archive>
18
            <manifest>
19
                <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
20
            </manifest>
21
        </archive>
22
    </configuration>
23
    <executions>
24
        <execution>
25
            <goals>
26
                <goal>repackage</goal>
27
            </goals>
28
        </execution>
29
    </executions>
30
</plugin>

使用场景:

生成可直接运行 java -jar app.jar 的包
微服务部署
容器化部署(Docker)

3.6 两个插件对比

公式:

1
maven-compiler-plugin = 编译期 (.java → .class)
2
spring-boot-maven-plugin = 打包期 (.class → 可执行 .jar)

生命周期位置:

1
validate → compile → test → package → install → deploy
2
           ↑                    ↑
3
    maven-compiler-plugin    spring-boot-maven-plugin
4
    (编译源代码)              (repackage 目标)

维度	maven-compiler-plugin	spring-boot-maven-plugin
阶段	编译期	打包期
输入	`.java` 文件	`.class` 文件 + 依赖 jar
输出	`.class` 文件	可执行 `.jar`
必需性	必需(所有 Java 项目)	Spring Boot 项目必需
独立性	可单独使用	依赖 compiler 的输出
产物大小	小(仅代码)	大(包含所有依赖)
默认绑定	compile 阶段	package 阶段(repackage 目标)

四、两种实践方案

4.1 方案一: 继承 Parent (推荐,最省事)

1
<!-- 获得版本管理和插件配置 -->
2
<parent>
3
    <groupId>org.springframework.boot</groupId>
4
    <artifactId>spring-boot-starter-parent</artifactId>
5
    <version>3.2.0</version>
6
</parent>
7

8
<dependencies>
9
    <!-- 真正引入依赖,无需写版本号 -->
10
    <dependency>
11
        <groupId>org.springframework.boot</groupId>
12
        <artifactId>spring-boot-starter-web</artifactId>
13
    </dependency>
14
</dependencies>

4.2 方案二: 自定义父工程 (当不能继承 Spring Boot Parent 时)

⚠️ 缺失: 插件配置

BOM Import 只引入版本管理,不包含插件配置。必须手动配置:

1
<dependencyManagement>
2
    <dependencies>
3
        <!-- 引入版本字典,不引入 jar 包 -->
4
        <dependency>
5
            <groupId>org.springframework.boot</groupId>
6
            <artifactId>spring-boot-dependencies</artifactId>
7
            <version>3.2.0</version>
8
            <type>pom</type>
9
            <scope>import</scope>
10
        </dependency>
11
    </dependencies>
12
</dependencyManagement>
13

14
<!-- 必须手动配置插件 -->
15
<build>
20 collapsed lines
16
    <plugins>
17
        <plugin>
18
            <groupId>org.apache.maven.plugins</groupId>
19
            <artifactId>maven-compiler-plugin</artifactId>
20
            <version>3.11.0</version>
21
            <configuration>
22
                <source>17</source>
23
                <target>17</target>
24
            </configuration>
25
        </plugin>
26
    </plugins>
27
</build>
28

29
<dependencies>
30
    <!-- 真正引入依赖,依然无需写版本号 -->
31
    <dependency>
32
        <groupId>org.springframework.boot</groupId>
33
        <artifactId>spring-boot-starter-web</artifactId>
34
    </dependency>
35
</dependencies>

方案对比:

特性	Parent 继承	BOM Import
依赖版本管理	✅ 自动	✅ 自动
插件版本管理	✅ 自动	❌ 需手动
Java 编译配置	✅ 自动	❌ 需手动
资源编码配置	✅ 自动	❌ 需手动
继承灵活性	❌ 单继承	✅ 可导入多个 BOM

五、核心结论

Parent 提供双重管理 → 依赖版本 + 插件配置
BOM 只管依赖版本 → 插件配置需手动补全
dependencyManagement 只是菜单 → 不会导致项目臃肿,只有 dependencies 才真正引入
Starter-Web 已包含 Starter → 无需重复引入
BOM + Import 破解单继承 → 代价是失去插件配置,需手动补充
Compiler 编译代码 → 生成 .class,是构建的第一步
Spring Boot Plugin 打包部署 → 生成可执行 jar,是构建的最后一步

Spring Boot Maven 依赖与插件管理：从 Parent 到 BOM 的完整机制

Spring Boot Maven 依赖与插件管理:从 Parent 到 BOM 的完整机制

一、Maven 基础机制

1.1 Maven 依赖分类

1.2 parent 标签 (继承机制)

1.3 dependencyManagement 标签 (版本管理)

1.4 pluginManagement 标签 (插件管理)

1.5 三个核心标签对比

二、Spring Boot 核心概念

2.1 spring-boot-starter-parent vs spring-boot-starter

三、Maven 插件机制

3.1 插件标签结构

3.2 生命周期与插件绑定

3.3 pluginManagement vs plugins

3.4 maven-compiler-plugin (编译插件)

3.5 spring-boot-maven-plugin (Spring Boot 打包插件)

3.6 两个插件对比

四、两种实践方案

4.1 方案一: 继承 Parent (推荐,最省事)

4.2 方案二: 自定义父工程 (当不能继承 Spring Boot Parent 时)

五、核心结论

参考资料

Maven 基础机制

BOM 与依赖管理

Maven 插件

官方文档