Spring Boot 依赖管理： `spring-boot-starter-parent` 与 `spring-boot-dependencies`

06-01 1176阅读

前言

在 Spring Boot 的开发实践中，依赖管理是构建高质量应用的基础。spring-boot-starter-parent 和 spring-boot-dependencies 是 Spring Boot 提供的两大核心依赖管理工具，它们在简化依赖版本控制、统一配置等方面发挥着关键作用。

一、核心概念解析

1.1 spring-boot-starter-parent

定义：
是一个 Maven 父 POM，提供默认的项目配置（如编码、插件、资源处理）和依赖版本管理。

核心功能：

依赖版本管理：通过继承 spring-boot-dependencies，自动管理所有 Spring Boot 依赖的版本。

默认配置：

编译参数（如 Java 版本、编码格式）。
插件配置（如 maven-compiler-plugin、spring-boot-maven-plugin）。
资源处理（自动替换 application.properties 中的占位符）。

标准化构建：确保多模块项目的一致性。

1.2 spring-boot-dependencies

定义：
是一个 BOM（Bill of Materials），仅管理依赖版本，不提供其他配置。

核心功能：

版本集中控制：通过声明所有依赖的版本。
兼容性保障：确保 Spring Boot 生态内依赖的版本兼容性。

灵活性：可与现有父 POM 结合使用，避免替换原有配置。

1.3 核心关系图

二、核心区别对比

2.1 核心差异表

特性	spring-boot-starter-parent	spring-boot-dependencies
类型	Maven 父 POM	BOM（依赖版本清单）
作用范围	依赖版本管理 + 默认配置（插件、编码、资源处理）	仅依赖版本管理
继承关系	继承自 spring-boot-dependencies	独立存在，不依赖其他 POM
使用方式	通过标签继承	通过 + 引入
是否引入依赖	不直接引入依赖，但通过 BOM 管理版本	仅定义版本，不引入任何依赖

2.2 关键关系图

三、使用场景与最佳实践

3.1 spring-boot-starter-parent 的适用场景

新建 Spring Boot 项目：

作为父 POM 直接继承，快速搭建标准化项目。


    org.springframework.boot
    spring-boot-starter-parent
    3.2.0

统一配置需求：

需要统一 Java 版本、编码、插件配置的多模块项目。

3.2 spring-boot-dependencies 的适用场景

已有父 POM 的项目：

不想替换原有父 POM，但需管理 Spring Boot 依赖版本。


    
        
            org.springframework.boot
            spring-boot-dependencies
            3.2.0
            pom
            import

灵活版本覆盖：

需要自定义部分依赖版本时，通过覆盖。

    5.9.3

四、代码示例与实战

4.1 使用 spring-boot-starter-parent 的完整项目配置


    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        3.2.0
    
    
    
        17
    
    
        
        
            org.springframework.boot
            spring-boot-starter-web
        
    
    
        
            
            
                org.springframework.boot
                spring-boot-maven-plugin

4.2 使用 spring-boot-dependencies 的独立配置


    4.0.0
    
    
        
            
                org.springframework.boot
                spring-boot-dependencies
                3.2.0
                pom
                import
            
        
    
    
        
        
            org.springframework.boot
            spring-boot-starter-web
        
    
    
    
        
            
                org.springframework.boot
                spring-boot-maven-plugin

五、高级技巧与最佳实践

5.1 覆盖依赖版本

在 spring-boot-starter-parent 中，通过覆盖版本：

    5.9.3
    1.2.11

5.2 自定义父 POM

若需扩展功能，可创建自己的父 POM：


    
        org.springframework.boot
        spring-boot-starter-parent
        3.2.0
    
    
    com.example
    custom-parent
    
    
        17

5.3 版本冲突解决

通过 spring-boot-dependencies 确保版本一致性：


    com.example
    custom-library
    1.0.0

六、总结与选择建议

6.1 核心总结

场景	推荐方案	原因
新项目快速搭建	spring-boot-starter-parent	提供默认配置，开箱即用
已有父 POM 的项目	spring-boot-dependencies	灵活管理版本，不破坏现有配置
需要完全控制配置	spring-boot-dependencies	自定义插件、编码等细节

6.2 选择建议

优先使用 spring-boot-starter-parent：
当项目需要统一配置（如插件、编码、资源处理），且无现有父 POM 限制时。
选择 spring-boot-dependencies：
当需要与现有父 POM 结合，或需自定义依赖版本时。
七、常见问题解答

7.1 为什么 spring-boot-starter-parent 需要继承 spring-boot-dependencies？
- 原因：spring-boot-starter-parent 通过继承 spring-boot-dependencies 的 BOM，确保依赖版本的统一管理，避免版本冲突。
  7.2 如何验证依赖版本是否被正确管理？
  - 方法：
    使用 mvn dependency:tree 命令查看依赖树，确认版本是否符合预期。
    八、总结
    - spring-boot-starter-parent 是“一站式”解决方案，适合快速搭建标准Spring Boot项目。
    - spring-boot-dependencies 是轻量级的依赖版本管理工具，适合需要灵活控制配置的复杂场景。
    - 关键关系：spring-boot-starter-parent 内部已继承 spring-boot-dependencies，因此前者包含了后者的所有功能，但额外提供了默认配置。
    （图片来源网络，侵删）
    （图片来源网络，侵删）
    （图片来源网络，侵删）

免责声明：我们致力于保护作者版权，注重分享，被刊用文章因无法核实真实出处，未能及时与作者取得联系，或有版权异议的，请联系管理员，我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理! 图片声明：本站部分配图来自人工智能系统AI生成,觅知网授权图片,PxHere摄影无版权图库和百度，360，搜狗等多加搜索引擎自动关键词搜索配图，如有侵权的图片，请第一时间联系我们。