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

 更新时间:2025年08月06日 11:33:56   作者:TracyCoder123  
这篇文章主要介绍了Spring Boot父子工程POM依赖关系的相关资料,Spring Boot父子工程通过Maven继承机制实现统一版本、依赖和插件管理,模块化开发与代码复用,提升项目可维护性与效率,需要的朋友可以参考下

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
apiAPI接口定义、DTOcommon、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依赖关系内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • springboot 整合 seata的配置过程

    springboot 整合 seata的配置过程

    本文给大家介绍springboot 整合 seata的配置过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2021-08-08
  • JavaMail入门教程之创建邮件(2)

    JavaMail入门教程之创建邮件(2)

    这篇文章主要介绍了JavaMail入门教程之创建邮件的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-11-11
  • java中通过网卡名称获取IP地址

    java中通过网卡名称获取IP地址

    java中通过网卡名称获取IP地址,需要的朋友可以参考一下
    2013-04-04
  • Java多态中动态绑定原理解析

    Java多态中动态绑定原理解析

    这篇文章主要介绍了Java多态中动态绑定原理解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-12-12
  • SpringBoot 任务调度动态设置方式(不用重启服务)

    SpringBoot 任务调度动态设置方式(不用重启服务)

    这篇文章主要介绍了SpringBoot 任务调度 动态设置方式(不用重启服务),具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-11-11
  • Java1.7全网最深入HashMap源码解析

    Java1.7全网最深入HashMap源码解析

    HashMap 是一个散列表,它存储的内容是键值对(key-value)映射。HashMap 实现了 Map 接口,根据键的 HashCode 值存储数据,具有很快的访问速度,最多允许一条记录的键为 nul
    2021-11-11
  • SpringBoot实现重试机制的四种方案

    SpringBoot实现重试机制的四种方案

    在分布式系统和微服务架构中,服务调用失败是不可避免的现象,网络不稳定、服务过载、临时故障等因素都可能导致调用失败,重试机制作为一种处理临时性故障的解决方案,能够有效提高系统的可用性,需要的朋友可以参考下
    2025-04-04
  • SpringBoot自定义注解之实现AOP切面日志详解

    SpringBoot自定义注解之实现AOP切面日志详解

    这篇文章主要为大家详细介绍了SpringBoot自定义注解之实现AOP切面统一打印出入参日志,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-09-09
  • java 中的乱码问题汇总及解决方案

    java 中的乱码问题汇总及解决方案

    这篇文章主要介绍了java 中的乱码问题汇总相关资料,并附解决方案,出现乱码问题有编码与解码,字节流与字符流出现乱码,等其他情况,需要的朋友可以参考下
    2016-11-11
  • JAVA并发中VOLATILE关键字的神奇之处详解

    JAVA并发中VOLATILE关键字的神奇之处详解

    这篇文章主要给大家介绍了关于JAVA并发中VOLATILE关键字的神奇之处的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-05-05

最新评论