Maven依赖pom类型模块无法引入其子模块的解决方案咨询

问题背景 #

项目结构如下：

root
|
+--Module 1
|  |
|  +--Submodule_1
|  |
|  +--Submodule_2
|  |
|  +--Submodule_N
|
+--Module 2

需求：Module 2依赖Module 1，希望仅通过依赖Module 1就能自动引入其所有子模块（Submodule_1至Submodule_N）的类。

当前配置运行报错：package com.example.submodule_n.x.y does not exist，原因是pom类型的聚合模块（Module 1）不会自动传递其子模块的依赖。若在Module 1中添加对子模块的依赖，会触发Maven循环引用错误：...is referencing itself（因为子模块的parent是Module 1，形成Module 1 → 子模块 → Module 1的循环）。

可行解决方案 #

方案1：新增依赖聚合模块 #

通过创建一个专门的依赖聚合模块，统一管理Module 1下所有子模块的依赖，让Module 2只需依赖该模块即可一次性引入所有子模块。

步骤1：创建Module_1_deps模块

新增Module_1_deps目录，其pom.xml配置如下：

<project>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>root</artifactId>
        <version>master</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>Module_1_deps</artifactId>
    <packaging>pom</packaging>

    <dependencies>
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>Submodule_1</artifactId>
            <version>master</version>
        </dependency>
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>Submodule_2</artifactId>
            <version>master</version>
        </dependency>
        <!-- 依次添加所有Submodule_N的依赖 -->
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>Submodule_N</artifactId>
            <version>master</version>
        </dependency>
    </dependencies>
</project>

步骤2：更新root模块的聚合配置

在root的pom.xml中添加新模块：

<modules>
    <module>Module_1</module>
    <module>Module_1_deps</module> <!-- 新增 -->
    <module>Module_2</module>
</modules>

步骤3：修改Module 2的依赖配置

将Module 2中对Module 1的依赖替换为对Module_1_deps的依赖：

<dependencies>
    <dependency>
        <groupId>com.example</groupId>
        <artifactId>Module_1_deps</artifactId>
        <version>master</version>
        <type>pom</type>
        <scope>compile</scope>
    </dependency>
</dependencies>

方案2：利用Dependency Management统一管理（需逐个引入子模块） #

若不想新增模块，可以通过Module 1的dependencyManagement统一管理子模块版本，Module 2只需声明依赖即可（无需重复写版本）。

步骤1：更新Module 1的pom.xml

添加dependencyManagement节点，声明所有子模块的依赖：

<project>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>root</artifactId>
        <version>master</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>Module_1</artifactId>
    <packaging>pom</packaging>

    <modules>
        <module>Submodule_1</module>
        <module>Submodule_2</module>
        ...
        <module>Submodule_N</module>
    </modules>

    <!-- 新增dependencyManagement -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.example</groupId>
                <artifactId>Submodule_1</artifactId>
                <version>master</version>
            </dependency>
            <dependency>
                <groupId>com.example</groupId>
                <artifactId>Submodule_2</artifactId>
                <version>master</version>
            </dependency>
            <!-- 所有Submodule_N的版本声明 -->
            <dependency>
                <groupId>com.example</groupId>
                <artifactId>Submodule_N</artifactId>
                <version>master</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
</project>

步骤2：修改Module 2的pom.xml

先导入Module 1的依赖管理，再声明所有子模块的依赖（无需写版本）：

<project>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>root</artifactId>
        <version>master</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>Module_2</artifactId>

    <!-- 导入Module 1的依赖管理 -->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.example</groupId>
                <artifactId>Module_1</artifactId>
                <version>master</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- 逐个声明子模块依赖，版本由Module 1统一管理 -->
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>Submodule_1</artifactId>
        </dependency>
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>Submodule_2</artifactId>
        </dependency>
        ...
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>Submodule_N</artifactId>
        </dependency>
    </dependencies>
</project>

说明 #

• 方案1完全符合"仅依赖一个模块即可引入所有子模块"的需求，适合子模块较多的场景，后续新增子模块只需在Module_1_deps中添加依赖即可。
• 方案2无需新增模块，但仍需在Module 2中逐个声明子模块依赖，适合子模块较少或需要更精细控制依赖的场景。

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