Spring Boot中starter-parent与dependencies的差异解析

1. 为什么需要区分这两个POM文件

在Spring Boot项目中，我们经常会看到pom.xml中引入spring-boot-starter-parent或者spring-boot-dependencies作为父POM。很多开发者对这两者的区别感到困惑，甚至认为它们可以互相替代。实际上，这两个POM文件虽然都提供了依赖管理功能，但设计目的和使用场景有着本质区别。

我接手过不少Spring Boot项目，发现很多团队在这两个选择上存在误用。有的项目盲目使用spring-boot-starter-parent导致构建过程被过度约束，有的则错误地认为spring-boot-dependencies可以完全替代parent的功能。这些误用往往在项目后期才会暴露问题，比如需要自定义构建配置时遇到阻碍，或者发现某些插件行为不符合预期。

2. spring-boot-starter-parent的核心功能解析

2.1 依赖管理机制

spring-boot-starter-parent作为父POM，最显著的功能是提供了完整的依赖管理。它通过<dependencyManagement>节点预先定义了Spring Boot生态系统中所有官方starter和相关库的版本。这意味着当我们在项目中添加Spring Boot相关依赖时，可以省略版本号，由父POM统一管理。

例如，添加web starter时只需这样声明：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

这种设计带来了几个实际好处：

1. 版本一致性：所有Spring Boot组件自动保持版本兼容
2. 简化配置：无需手动维护大量版本号
3. 升级便利：只需修改parent版本即可升级整个技术栈

2.2 默认构建配置

除了依赖管理，spring-boot-starter-parent还预配置了大量构建相关的默认设置。这些配置在Maven构建生命周期的各个阶段都会生效：

• 编译器设置：默认使用Java 1.8兼容级别
• 资源过滤：支持application.properties中的占位符替换
• 插件配置：预定义了spring-boot-maven-plugin等核心插件的默认行为
• 编码设置：统一使用UTF-8编码

这些默认配置对于快速启动项目非常有利，但也意味着如果你需要自定义这些构建行为，就必须通过覆盖配置的方式来实现。

2.3 预定义的属性值

spring-boot-starter-parent定义了大量可在子POM中引用的属性，这些属性通常用于统一管理各种配置值：

properties复制<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

开发者可以通过覆盖这些属性值来调整项目配置，而不需要完全重写对应的插件配置。

3. spring-boot-dependencies的定位与作用

3.1 纯粹的依赖管理POM

spring-boot-dependencies是一个只包含<dependencyManagement>的POM文件，它提供了与spring-boot-starter-parent完全相同的依赖版本管理功能，但不包含任何构建配置或插件定义。这种"纯净"的特性使其非常适合以下场景：

1. 项目已经有一个自定义的父POM
2. 需要更灵活地控制构建过程
3. 项目使用Gradle等非Maven构建工具

在pom.xml中引入方式如下：

xml复制<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>${spring-boot.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2 与自定义父POM的协作模式

在企业级项目中，我们通常会有一个公司级别的父POM来统一管理组织内部的构建标准和规范。这种情况下，使用spring-boot-dependencies是最佳选择：

xml复制<parent>
    <groupId>com.company</groupId>
    <artifactId>company-standard-parent</artifactId>
    <version>1.0.0</version>
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

这种模式既保持了公司标准的构建配置，又能够享受Spring Boot的依赖管理便利。

4. 关键差异对比与选型建议

4.1 功能对比表

4.2 实际项目中的选择策略

根据我参与过的多个Spring Boot项目经验，选择建议如下：

1. 全新Spring Boot项目：如果没有特殊构建需求，使用spring-boot-starter-parent可以快速启动项目，减少初始配置工作。

2. 企业级项目：当项目需要继承公司标准父POM时，必须使用spring-boot-dependencies来引入Spring Boot的依赖管理。

3. 需要高度定制构建：如果项目需要对Maven构建过程进行深度定制（如特殊打包需求、自定义插件配置等），建议使用spring-boot-dependencies。

4. 多模块项目：在大型多模块项目中，可以在父模块中使用spring-boot-dependencies，然后在子模块中根据需要引入特定starter。

4.3 常见误区与避坑指南

误区一：认为两者可以随意互换

实际上，从spring-boot-starter-parent切换到spring-boot-dependencies时，必须手动补充所有原本由parent提供的构建配置，否则可能导致构建失败或行为不一致。

误区二：混合使用两者

xml复制<!-- 错误示例 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.0</version>
</parent>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

这种配置会导致依赖版本管理混乱，绝对应该避免。

实践建议：当从spring-boot-starter-parent迁移到spring-boot-dependencies时，建议：

1. 记录当前项目的完整构建行为
2. 逐步迁移配置，验证每个步骤
3. 特别注意资源过滤、插件配置等差异点

5. 高级应用场景与技巧

5.1 覆盖默认依赖版本

有时我们需要使用与Spring Boot默认不同的第三方库版本。两种方式处理方式不同：

使用spring-boot-starter-parent时：

xml复制<properties>
    <mybatis.version>3.5.10</mybatis.version>
</properties>

使用spring-boot-dependencies时：

xml复制<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.10</version>
        </dependency>
    </dependencies>
</dependencyManagement>

5.2 多Spring Boot版本共存的解决方案

在微服务架构中，不同服务可能基于不同Spring Boot版本。使用spring-boot-dependencies可以更灵活地管理：

xml复制<dependencyManagement>
    <dependencies>
        <!-- 核心服务使用2.7.x -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.5</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        
        <!-- 特定模块使用3.x -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>3.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

5.3 自定义starter开发时的选择

当开发自定义starter时，建议完全避免使用spring-boot-starter-parent，而是：

1. 使用最小化的父POM
2. 按需引入spring-boot-dependencies
3. 显式声明所有依赖的版本范围

这样可以确保starter在各种环境下都能正确工作，不会与使用者的构建配置产生冲突。