章
目
录
有时候，Maven管理项目会遇到这样的情况：项目里有两个模块，它们相互之间都需要引用对方的代码和资源。这时候该怎么处理呢？今天就来详细讲讲这个问题的解决办法。
一、整体思路
在Maven项目体系里，如果要实现两个模块相互引用，一个常用且有效的方式是把这两个模块放在同一个父项目下面，利用父项目的聚合功能来管理它们。这样一来，模块之间的依赖关系就能顺利解析，项目构建也能正常进行。
二、项目结构搭建
假设我们有两个需要相互引用的模块，分别命名为module-a和module-b 。我们先创建一个父项目，这里取名为parent-project。项目的目录结构大致如下：
parent-project
│
├── module-a
│ └── pom.xml
│
├── module-b
│ └── pom.xml
│
└── pom.xml
从这个结构可以看出，父项目parent-project下包含了module-a和module-b两个子模块，每个子模块都有自己的pom.xml文件，用于管理自身的依赖和构建配置，同时父项目也有一个pom.xml，用于管理整个项目的聚合信息。
三、配置pom.xml文件
（一）父项目的pom.xml配置
父项目的pom.xml是整个项目的“总指挥”，在这个文件里，我们要声明包含哪些子模块。具体配置如下：
<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.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>
<!-- 声明子模块 -->
<modules>
<module>module-a</module>
<module>module-b</module>
</modules>
<properties>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties>
</project>
这里面，<groupId>、<artifactId>和<version>分别定义了项目的组ID、工件ID和版本号。<packaging>设置为pom，表示这是一个用于聚合模块的项目。<modules>标签里列出了所有的子模块，这样Maven就能知道这个项目包含哪些模块，以及如何对它们进行管理。
（二）module-a的pom.xml配置
接下来看module-a的pom.xml，在这个文件里，我们要声明对module-b的依赖。具体代码如下：
<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>
<!-- 声明父项目信息 -->
<parent>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>module-a</artifactId>
<!-- 声明对module-b的依赖 -->
<dependencies>
<dependency>
<groupId>com.example</groupId>
<artifactId>module-b</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</project>
在这个配置中，<parent>标签指定了module-a的父项目信息，这样module-a就能继承父项目的一些配置。<dependencies>标签里声明了对module-b的依赖，其中${project.version}表示使用父项目的版本号，这样能确保子模块的版本和父项目保持一致。
（三）module-b的pom.xml配置
module-b的pom.xml和module-a类似，也要声明对module-a的依赖，配置如下：
<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>
<parent>
<groupId>com.example</groupId>
<artifactId>parent-project</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<artifactId>module-b</artifactId>
<dependencies>
<dependency>
<groupId>com.example</groupId>
<artifactId>module-a</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
</project>
这样，module-b就声明了对module-a的依赖，整个项目的模块依赖关系就建立起来了。
四、项目构建
完成上述配置后，就可以进行项目构建了。
（一）安装父项目
在父项目的根目录下，打开命令行工具，执行以下命令：
mvn clean install
这个命令会清理之前构建产生的文件，然后将所有子模块安装到本地仓库。通过这种方式，所有子模块的依赖都会被正确处理，确保项目能够顺利构建。
（二）构建子模块
我们既可以分别进入module-a和module-b目录，在各自目录下执行mvn clean install命令来单独构建子模块；也可以直接在父项目的根目录下执行mvn clean install命令，这样就能一次性构建整个项目。
五、注意事项
（一）避免循环依赖
虽然Maven允许模块之间相互依赖，但在实际开发中，一定要尽量避免循环依赖的情况。什么是循环依赖呢？简单来说，就是module-a依赖module-b，而module-b又依赖module-a，形成了一个依赖闭环。这种情况可能会导致项目构建失败，即使构建成功，后续的代码维护也会变得非常困难，因为代码之间的调用关系变得复杂混乱。
（二）统一版本管理
要确保所有模块的版本一致，在配置依赖时，使用${project.version}来引用父项目的版本号，这样可以保证子模块的版本始终与父项目同步。如果各个模块版本不一致，可能会出现兼容性问题，导致项目运行出错。
（三）关注依赖顺序
一般情况下，Maven会根据模块的依赖关系自动确定构建顺序。但有些特殊情况下，可能需要我们手动调整模块的构建顺序。比如，某个模块依赖的其他模块还没有构建完成，就会导致构建失败。这时候，我们就需要根据实际情况，合理调整模块的构建顺序，确保项目能够顺利构建。
通过以上步骤和注意事项，我们就能很好地解决Java项目中Maven两个模块相互引用的问题，你学会了吗？
