Maven dependencyManagement未按预期生效，如何统一管理依赖版本？

要实现「所有版本在一个pom.xml中管理，子项目无需声明版本」，核心是用好Maven的<dependencyManagement>机制配合父pom继承，完全不需要把依赖都放到<dependencies>里再排除，具体步骤如下：

1. 配置依赖管理项目为pom类型 #

你的dependency-management项目必须设置packaging=pom，因为它只负责版本管理，不需要编译生成jar包。在它的pom里，通过<dependencyManagement>集中声明所有需要统一版本的依赖，包括Spring Boot的官方依赖管理。

示例dependency-management项目的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>

    <groupId>com.your.group</groupId>
    <artifactId>dependency-management</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <!-- 用properties统一管理版本号，方便后续批量修改 -->
    <properties>
        <spring-boot.version>2.7.15</spring-boot.version>
        <querydsl-jpa.version>5.0.0</querydsl-jpa.version>
        <commons-text.version>1.10.0</commons-text.version>
    </properties>

    <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>
            </dependency>

            <!-- 声明自定义依赖的版本 -->
            <dependency>
                <groupId>com.querydsl</groupId>
                <artifactId>querydsl-jpa</artifactId>
                <version>${querydsl-jpa.version}</version>
            </dependency>

            <dependency>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-text</artifactId>
                <version>${commons-text.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

2. 子项目（library）继承依赖管理pom #

在library项目的pom中，通过<parent>标签指定继承dependency-management项目，这样子项目中的依赖就能自动使用父pom里定义的版本，无需手动声明<version>。

示例library项目的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 -->
    <parent>
        <groupId>com.your.group</groupId>
        <artifactId>dependency-management</artifactId>
        <version>1.0.0</version>
    </parent>

    <groupId>com.your.group</groupId>
    <artifactId>library</artifactId>
    <version>1.0.0</version>

    <dependencies>
        <!-- 无需声明version，自动使用父pom定义的版本 -->
        <dependency>
            <groupId>com.querydsl</groupId>
            <artifactId>querydsl-jpa</artifactId>
        </dependency>

        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-text</artifactId>
        </dependency>

        <!-- Spring Boot的依赖也无需声明version，继承自spring-boot-dependencies -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

关键注意事项 #

• 依赖管理项目必须是packaging=pom，否则Maven不会识别它的<dependencyManagement>配置。
• 子项目必须通过<parent>明确继承，否则无法获取父pom的版本定义。
• Spring Boot的依赖管理要通过<scope>import</scope>的方式导入到父pom的<dependencyManagement>中，而不是直接放到<dependencies>里，这样才能让子项目继承Spring Boot的版本。
• 所有需要统一版本的依赖，都要在父pom的<dependencyManagement>里声明，子项目只需要在<dependencies>里引用groupId和artifactId即可。

内容的提问来源于stack exchange，提问作者tomas