自定义含Spring Cloud与Spring Boot Starter Parent的父POM问题

我完全懂你的困扰——当项目已经继承了spring-boot-starter-parent，再想用自定义父POM统一管理公共依赖，直接用dependencyManagement好像没起作用。其实核心思路是分层继承：让你的自定义父POM先继承Spring Boot的父POM，然后业务项目再继承这个自定义父POM，这样就能同时享用Spring Boot的依赖管理和你自己的公共依赖配置了。

步骤1：创建自定义父POM #

这个父POM不需要任何业务代码，只负责依赖管理，结构大概是这样：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!-- 先继承Spring Boot的父POM，保留它的依赖管理能力 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>你的Spring Boot版本号</version>
        <relativePath/> <!-- 让Maven自动从仓库查找，本地开发可指定相对路径 -->
    </parent>

    <groupId>com.yourcompany</groupId>
    <artifactId>custom-spring-cloud-parent</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>
    <name>Custom Spring Cloud Parent</name>
    <description>统一管理所有Spring Cloud项目的公共依赖</description>

    <!-- 配置Spring Cloud版本，确保和Spring Boot版本兼容 -->
    <properties>
        <spring-cloud.version>你的Spring Cloud版本号</spring-cloud.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <!-- 引入Spring Cloud官方依赖管理，统一控制Cloud组件版本 -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <!-- 这里添加你的公共依赖，比如自定义工具包、通用组件等 -->
            <dependency>
                <groupId>com.yourcompany</groupId>
                <artifactId>common-utils</artifactId>
                <version>2.0.0</version>
            </dependency>
            <dependency>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-lang3</artifactId>
                <version>3.12.0</version>
            </dependency>
            <!-- 更多公共依赖可以继续添加 -->
        </dependencies>
    </dependencyManagement>

    <!-- 可选：统一配置插件版本，避免每个项目重复写 -->
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${spring-boot.version}</version>
            </plugin>
            <!-- 其他常用插件比如maven-compiler-plugin也可以在这里配置 -->
        </plugins>
    </pluginManagement>
</project>

步骤2：修改业务项目的POM #

把原来直接继承spring-boot-starter-parent的地方，改成继承你的自定义父POM：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!-- 现在继承自定义父POM，间接获取Spring Boot的依赖管理 -->
    <parent>
        <groupId>com.yourcompany</groupId>
        <artifactId>custom-spring-cloud-parent</artifactId>
        <version>1.0.0</version>
        <!-- 本地开发时可指定相对路径，比如../custom-spring-cloud-parent/pom.xml -->
    </parent>

    <groupId>com.yourcompany</groupId>
    <artifactId>your-business-service</artifactId>
    <version>1.0.0</version>
    <name>Your Business Service</name>

    <dependencies>
        <!-- 直接引入依赖，不需要写版本号，自动从父POM的dependencyManagement中获取 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <!-- 引入自定义公共依赖，同样不需要写版本 -->
        <dependency>
            <groupId>com.yourcompany</groupId>
            <artifactId>common-utils</artifactId>
        </dependency>
    </dependencies>

    <!-- 使用父POM中配置的插件，无需重复指定版本 -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

关键说明 #

• 为什么这样生效？ Maven的继承是链式的，自定义父POM继承了Spring Boot的父POM，所以业务项目会间接继承Spring Boot的所有依赖管理规则，同时又能加载你自定义的公共依赖配置，两者完全不冲突。
• 版本兼容问题：一定要确保spring-cloud.version和Spring Boot版本匹配（比如Spring Boot 2.7.x对应Spring Cloud 2021.0.x，也就是Ilford版本），避免出现依赖冲突。
• 版本覆盖：如果某个依赖你想使用特殊版本，直接在业务项目的dependencies中指定版本号即可，Maven会优先使用业务项目中定义的版本。

这样就能完美实现所有Spring Cloud项目的公共依赖统一管理，既保留了Spring Boot的原生配置，又减少了重复代码~

内容的提问来源于stack exchange，提问作者Débora