Java基础教程（159）Maven之模块管理：Maven模块化，拆出来的艺术，告别“面条式”代码！

原创于 2025-08-22 14:19:34 发布 · 444 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#java #maven

Java基础教程专栏收录该内容

302 篇文章

订阅专栏

在软件开发中，随着项目规模的增长，将所有代码塞进一个单一项目（Monolith）会带来依赖管理混乱、构建缓慢、团队协作效率低下等一系列问题。Maven的多模块管理（Multi-Module）功能正是为此而生，它能将一个大项目拆分为多个高内聚、低耦合的子模块，实现真正的模块化开发。

一、为何需要模块化？

代码复用：通用组件可被多个模块依赖，避免重复代码。
关注点分离：各模块职责单一，如api、service、dao、web等，结构清晰。
统一构建：一键构建所有模块，保持依赖版本一致。
并行开发：团队可基于不同模块并行工作，减少冲突。

二、核心概念：父POM与子模块

Maven多模块项目有一个父项目（聚合项目） 和多个子模块。父项目本身不包含业务代码，它通过<modules>聚合子模块，并通过<dependencyManagement>统一管理依赖版本。

关键配置：

父POM的packaging：必须为pom。
<modules>：声明所有子模块。
<dependencyManagement>：定义依赖版本（声明但不引入），子模块需显式引用所需依赖，无需指定版本。
<pluginManagement>：统一管理插件配置。

三、实战示例：构建一个多模块项目

假设我们要构建一个项目my-app，包含核心模块、服务模块和Web模块。

项目结构：

my-app (父模块, packaging为pom)
├── my-app-core (核心模块)
├── my-app-service (服务模块，依赖core)
├── my-app-web (Web模块，依赖service)
└── pom.xml (父POM)

1. 父模块POM (my-app/pom.xml)

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>my-app</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>pom</packaging> <!-- 关键！ -->

    <modules>
        <module>my-app-core</module>
        <module>my-app-service</module>
        <module>my-app-web</module>
    </modules>
    <properties>
        <spring.version>5.3.23</spring.version>
        <junit.version>5.9.2</junit.version>
    </properties>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-context</artifactId>
                <version>${spring.version}</version>
            </dependency>
            <dependency>
                <groupId>org.junit.jupiter</groupId>
                <artifactId>junit-jupiter</artifactId>
                <version>${junit.version}</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <build>
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.11.0</version>
                    <configuration>
                        <source>11</source>
                        <target>11</target>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

2. 子模块POM (my-app/my-app-service/pom.xml)

该模块依赖my-app-core。

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>my-app</artifactId>
        <version>1.0.0-SNAPSHOT</version>
    </parent>
    <artifactId>my-app-service</artifactId>
    <dependencies>
        <!-- 首先，声明对自家核心模块的依赖 -->
        <dependency>
            <groupId>com.example</groupId>
            <artifactId>my-app-core</artifactId>
            <version>${project.version}</version> <!-- 版本与父模块同步 -->
        </dependency>
        <!-- 父POM中managed的依赖，此处无需版本 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context</artifactId>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
        </dependency>
    </dependencies>
</project>

3. 构建与安装

在父项目根目录my-app/下执行命令，Maven会根据模块依赖关系自动按顺序构建所有子模块。

mvn clean install

四、最佳实践与常见陷阱

循环依赖：严禁模块间出现循环依赖（如A依赖B，B又依赖A）。Maven会报错，这同时也是糟糕设计的信号。
依赖作用域（Scope）：合理使用compile、provided、test等作用域，避免不必要的依赖传递。例如，Servlet API在web模块中应设为provided。
版本管理：强烈推荐在父POM的<dependencyManagement>中统一管理所有依赖的版本，这是保持一致性的关键。
聚合与继承：Maven的聚合（<modules>）和继承（<parent>）通常一起使用，但它们是两个不同的概念。一个项目可以聚合但不继承其他模块，反之亦然。