Maven模块化管理：巧用packaging标签优化多模块项目

在复杂的Java项目中，合理使用Maven的packaging标签是模块化管理的核心技能。本文将通过实际案例，详解如何通过packaging类型的选择和组合，构建清晰、可维护的多模块架构。

一、Maven packaging基础

Maven的packaging标签定义了项目的最终输出类型，常见类型如下：

二、多模块项目结构设计

2.1 经典分层架构

my-project/
├── pom.xml (parent)
├── api/
│   ├── pom.xml (jar)
│   └── src/
│       └── java/
│           └── com/example/api/...
├── service/
│   ├── pom.xml (jar)
│   └── src/
│       └── java/
│           └── com/example/service/...
├── web/
│   ├── pom.xml (war)
│   └── src/
│       ├── java/
│       │   └── com/example/web/...
│       └── webapp/
│           └── WEB-INF/
│               └── web.xml

2.2 关键配置要点

• 父POM (pom.xml):

  <packaging>pom</packaging>
  <modules>
      <module>api</module>
      <module>service</module>
      <module>web</module>
  </modules>
  

• 子模块 (api/pom.xml):

  <packaging>jar</packaging>
  

• Web模块 (web/pom.xml):

  <packaging>war</packaging>
  <dependencies>
      <dependency>
          <groupId>com.example</groupId>
          <artifactId>api</artifactId>
          <version>1.0-SNAPSHOT</version>
      </dependency>
  </dependencies>
  

三、高级技巧与实战

3.1 管理依赖版本（Parent POM）

<!-- parent/pom.xml -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.7.5</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3.2 灵活打包策略

情况1：开发环境使用JAR，生产环境打包WAR

<!-- web/pom.xml -->
<packaging>war</packaging>

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-jar-plugin</artifactId>
                    <executions>
                        <execution>
                            <phase>package</phase>
                            <goals>
                                <goal>jar</goal>
                            </goals>
                        </execution>
                    </plugins>
                </build>
            </profile>
    </profile>
</profiles>

情况2：通用库同时支持JAR/WAR

<!-- common/pom.xml -->
<packaging>pom</packaging>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                </execution>
            </plugins>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>war</goal>
                    </goals>
                </execution>
            </plugins>
        </plugin>
    </build>

四、最佳实践总结

1. 严格分层：遵循controller-service-dao经典分层，避免模块间循环依赖
2. 统一版本管理：通过Parent POM集中控制依赖版本
3. 灵活打包：利用Maven Profiles应对不同环境需求
4. 资源隔离：通过src/main/resources和src/test/resources明确配置文件归属
5. 构建优化：使用maven-compiler-plugin统一Java版本配置

   <build>
       <plugins>
           <plugin>
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-compiler-plugin</artifactId>
               <version>3.8.1</version>
               <configuration>
                   <source>1.8</source>
                   <target>1.8</target>
               </configuration>
           </plugin>
       </plugins>
   </build>
   

五、常见问题解决方案

5.1 依赖冲突排查

mvn dependency:tree -Dverbose

5.2 打包后缺失类

• 确保模块间依赖正确声明
• 检查WEB-INF/lib是否包含所有必要JAR包

5.3 多环境配置

推荐使用spring-boot的application-{profile}.yml机制：

# application-dev.yml
server:
  port: 8080

# application-prod.yml
server:
  port: 80

通过合理配置packaging标签和模块化设计，可以显著提升项目可维护性和构建效率。建议结合Maven生命周期和插件生态（如maven-shade-plugin）进一步扩展功能。对于复杂项目，可考虑使用Archetype生成标准化模块模板。