IDEA maven 多模块打包问题总结

2023年11月10日 268次阅读

在用IDEA构建maven多module项目时，碰到了一些问题，现在归纳总结如下。

假如一个maven项目下分为几个module，分别是不同的服务，以及common模块，结构如下：

shopping
├── common
├── mail-service
├── order-service
└── pay-service

则shopping pom大概率是如下内容：

  <modelVersion>4.0.0</modelVersion>

  <groupId>com.test.shop</groupId>
  <artifactId>shopping</artifactId>
  <version>0.0.1</version>
  <modules>
    <module>mail-service</module>
    <module>pay-service</module>
    <module>order-service</module>
    <module>common</module>
  </modules>
  <packaging>pom</packaging>

common pom的内容大概如下：

  <parent>
    <groupId>com.test.shop</groupId>
    <artifactId>shopping</artifactId>
    <version>0.0.1</version>
  </parent>
  <modelVersion>4.0.0</modelVersion>

  <artifactId>common</artifactId>
  <version>0.0.7</version>
  <packaging>jar</packaging>

  <distributionManagement>
    <repository>
      <id>nexus</id>
      <name>Releases</name>
      <url>http://192.168.1.17:8081/repository/maven-releases</url>
    </repository>
    <snapshotRepository>
      <id>nexus</id>
      <name>Snapshot</name>
      <url>http://192.168.1.17:8081/repository/maven-snapshots</url>
    </snapshotRepository>
  </distributionManagement>

pay-service和order-service的pom会依赖common:

<dependency>
    <groupId>com.test.shop</groupId>
    <artifactId>common</artifactId>
    <version>0.0.7</version>
</dependency>

因为pay-service和order-service依赖common模块（此时如果是在开发和测试阶段是不需要将common发布到maven私服仓库的，但如果要打包必需发布common），如果要单独打包pay-service或order-service，则需要将common发布到maven私服仓库。在common模块下执行 mvn deploy 将common发布到仓库，此时仅仅将common发布到了仓库，但由于common依赖其parent – shopping pom，而shopping pom并没有并发布到仓库，所以导致在打包pay-service或order-service时失败。

问题总结成一句话：在发布子module时，如果依赖parent的pom，那在deploy到仓库时，要将parent pom也发布到仓库，否则会因为找不到parent pom而无法打包。

解决这个问题有两种选择：

  1. 在parent的pom下执行deploy, 这样就会自动将parent pom以及sub module都发布到仓库。
  2. 或者将子module的parent去掉，不要依赖不在仓库中的pom，将子module提升为一个独立的maven项目单独发布。

这里我选择第一种方式：在parent pom下执行deploy，这样如果有多个了module需要部署到仓库也更方便。

将common pom中的 distributionManagement 删掉，在shopping pom中添加 distributionManagement：

  <distributionManagement>
    <repository>
      <id>nexus</id>
      <name>Releases</name>
      <url>http://192.168.1.17:8081/repository/maven-releases</url>
    </repository>
    <snapshotRepository>
      <id>nexus</id>
      <name>Snapshot</name>
      <url>http://192.168.1.17:8081/repository/maven-snapshots</url>
    </snapshotRepository>
  </distributionManagement>

此时在shopping目录下执行 mvn deploy 就会将shopping、common、pay-service以及order-service都发布到maven仓库，但如果只想发布shopping和common怎么办？

问题总结成一句话：parent pom在deploy时，默认会将所有子module都deploy到仓库中，如果不想让某个子module部署到仓库，可以在子module的pom中添加：

<properties>
    <maven.deploy.skip>true</maven.deploy.skip>
</properties>

在pay-service和order-service pom中添加如上属性，再deploy就不会发布这两个模块到仓库了。

Spring boot maven plugin问题

在打包spring boot项目时，需要使用如下插件：

      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>

如果在用maven构建多模块项目时，不要将此插件放到parent pom中，否则如果有sub module不是spring boot应用，在打包时就会出错。只将该插件添加到是spring boot项目的子模块。上面例子中common模块不是spring boot应用就不需要此插件，故不要将此插件放到shopping pom中。

https://stackoverflow.com/questions/7446599/how-to-deploy-only-the-sub-modules-using-maven-deploy

点赞