Spring Boot父子工程POM依赖关系举例详解_Java

1. 父子工程概述

spring boot 父子工程是一种多模块项目结构，通过 maven 的继承机制来管理依赖关系。这种结构具有以下优势：

统一版本管理：所有子模块使用相同的依赖版本
代码复用：公共代码可以提取到独立模块
模块化开发：不同功能模块独立开发和维护
依赖隔离：避免循环依赖，明确模块职责

2. 项目结构

spring-boot-parent/
├── parent-pom.xml          # 父工程pom
├── common/                 # 公共工具模块
│   └── pom.xml
├── api/                    # api接口模块
│   └── pom.xml
├── service/                # 业务服务模块
│   └── pom.xml
└── web/                    # web应用启动模块
    └── pom.xml

3. 父工程 pom 详解

3.1 基本信息配置

<groupid>com.example</groupid>
<artifactid>spring-boot-parent</artifactid>
<version>1.0.0</version>
<packaging>pom</packaging>  <!-- 关键：父工程必须是pom类型 -->

3.2 子模块声明

<modules>
    <module>common</module>
    <module>api</module>
    <module>service</module>
    <module>web</module>
</modules>

3.3 版本统一管理

<properties>
    <spring-boot.version>3.2.0</spring-boot.version>
    <spring-cloud.version>2023.0.0</spring-cloud.version>
    <mysql.version>8.0.33</mysql.version>
    <!-- 其他版本号... -->
</properties>

3.4 依赖管理 (dependencymanagement)

重要概念：dependencymanagement 不会直接引入依赖，只是管理版本号。

<dependencymanagement>
    <dependencies>
        <!-- spring boot 依赖管理 -->
        <dependency>
            <groupid>org.springframework.boot</groupid>
            <artifactid>spring-boot-dependencies</artifactid>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>  <!-- 导入spring boot的依赖管理 -->
        </dependency>
        
        <!-- 自定义依赖版本管理 -->
        <dependency>
            <groupid>mysql</groupid>
            <artifactid>mysql-connector-java</artifactid>
            <version>${mysql.version}</version>
        </dependency>
        
        <!-- 内部模块依赖管理 -->
        <dependency>
            <groupid>com.example</groupid>
            <artifactid>common</artifactid>
            <version>${project.version}</version>
        </dependency>
    </dependencies>
</dependencymanagement>

3.5 公共依赖 (dependencies)

所有子模块都会继承这些依赖：

<dependencies>
    <!-- 所有子模块都会自动包含这些依赖 -->
    <dependency>
        <groupid>org.springframework.boot</groupid>
        <artifactid>spring-boot-starter</artifactid>
    </dependency>
    
    <dependency>
        <groupid>org.projectlombok</groupid>
        <artifactid>lombok</artifactid>
        <optional>true</optional>
    </dependency>
</dependencies>

3.6 插件管理 (pluginmanagement)

<build>
    <pluginmanagement>
        <plugins>
            <!-- spring boot maven plugin -->
            <plugin>
                <groupid>org.springframework.boot</groupid>
                <artifactid>spring-boot-maven-plugin</artifactid>
                <version>${spring-boot.version}</version>
            </plugin>
        </plugins>
    </pluginmanagement>
</build>

4. 子模块 pom 详解

4.1 继承父工程

<parent>
    <groupid>com.example</groupid>
    <artifactid>spring-boot-parent</artifactid>
    <version>1.0.0</version>
    <relativepath>../parent-pom.xml</relativepath>
</parent>

4.2 模块特有依赖

<dependencies>
    <!-- 依赖其他子模块 -->
    <dependency>
        <groupid>com.example</groupid>
        <artifactid>common</artifactid>
        <!-- 不需要指定版本，由父工程管理 -->
    </dependency>
    
    <!-- 依赖外部库 -->
    <dependency>
        <groupid>mysql</groupid>
        <artifactid>mysql-connector-java</artifactid>
        <!-- 不需要指定版本，由父工程管理 -->
    </dependency>
</dependencies>

5. 依赖关系层次

5.1 依赖传递关系

web (启动模块)
├── service (业务服务)
│   ├── api (api接口)
│   │   └── common (公共工具)
│   └── common (公共工具)
└── common (公共工具)

5.2 各模块职责

模块	职责	主要依赖
common	公共工具类、常量、异常	hutool、fastjson、validation
api	api接口定义、dto	common、swagger
service	业务逻辑、数据访问	api、common、mybatis、redis
web	应用启动、控制器	service、actuator、devtools

6. 关键概念解析

6.1 dependencymanagement vs dependencies

dependencymanagement：版本管理，不引入依赖
dependencies：实际引入依赖

<!-- 父工程：只管理版本 -->
<dependencymanagement>
    <dependency>
        <groupid>mysql</groupid>
        <artifactid>mysql-connector-java</artifactid>
        <version>8.0.33</version>
    </dependency>
</dependencymanagement>

<!-- 子模块：实际引入依赖 -->
<dependencies>
    <dependency>
        <groupid>mysql</groupid>
        <artifactid>mysql-connector-java</artifactid>
        <!-- 版本由父工程管理 -->
    </dependency>
</dependencies>

6.2 继承机制

子模块自动继承父工程的：

公共依赖
版本管理
插件配置
属性定义

6.3 依赖作用域 (scope)

<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-test</artifactid>
    <scope>test</scope>  <!-- 仅测试时使用 -->
</dependency>

<dependency>
    <groupid>org.projectlombok</groupid>
    <artifactid>lombok</artifactid>
    <optional>true</optional>  <!-- 不会传递给依赖方 -->
</dependency>

7. 最佳实践

7.1 版本管理

所有版本号统一在父工程 properties 中定义
使用 ${property.name} 引用版本号
定期更新依赖版本

7.2 模块划分

按功能职责划分模块
避免循环依赖
保持模块独立性

7.3 依赖管理

公共依赖放在父工程
模块特有依赖放在子模块
合理使用依赖作用域

7.4 构建配置

只有启动模块配置 spring-boot-maven-plugin
统一编译和测试插件版本
配置合适的打包策略

8. 常见问题

8.1 依赖冲突

使用 mvn dependency:tree 查看依赖树
在父工程中排除冲突依赖
使用 exclusions 标签排除传递依赖

8.2 版本不一致

检查父工程版本管理是否完整
确保子模块正确继承父工程
验证 relativepath 配置是否正确

8.3 构建失败

检查模块依赖关系是否正确
验证插件配置是否兼容
确认 java 版本设置一致

9. 总结

spring boot 父子工程通过 maven 的继承机制实现了：

统一管理：版本、依赖、插件统一管理
模块化：功能模块独立开发和维护
复用性：公共代码和配置复用
可维护性：清晰的依赖关系和模块职责

这种结构特别适合中大型项目的开发和维护，能够有效提高开发效率和代码质量。

到此这篇关于spring boot父子工程pom依赖关系的文章就介绍到这了,更多相关springboot父子工程pom依赖关系内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

Spring Boot父子工程POM依赖关系举例详解

2025年08月06日 • Java •我要评论