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

一、Maven packaging基础

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

Packaging Type	适用场景	示例项目类型
jar	通用Java库/工具类	服务层、公共组件
war	Web应用（需Servlet容器支持）	Spring Boot Web应用
pom	项目聚合（父POM）	多模块项目根目录
ear	企业级应用（包含EJB等）	JBoss部署包

---

二、多模块项目结构设计

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生成标准化模块模板。