解决 Maven jar-with-dependencies 中的多个类副本问题

2024-03-16 06:15:49

Maven jar-with-dependencies：解决多个类副本问题

前言

在使用 Maven 构建自包含的可执行 jar 文件时，遇到一个奇怪的问题：jar-with-dependencies.jar 文件中存在每个类的两个副本。此外，Maven 还生成了一个不包含依赖项的 jar 文件。这篇文章将深入探讨问题的原因并提供解决方法。

问题概述

当使用 Maven 的 jar-with-dependencies 目标时，它会创建一个包含所有依赖项的 jar 文件。在正常情况下，我们期望 jar 文件中每个类只有一个副本。然而，在我遇到的问题中，jar 文件中每个类都有两个副本。这造成了不必要的文件大小增加和潜在的运行时问题。

解决方案

1. 检查依赖关系范围

Maven 中的依赖关系范围指定了依赖关系的传递性。确保所有依赖关系的范围都正确指定，例如 compile、runtime 或 test。不正确的范围可能会导致 Maven 复制类。

2. 清理 Maven 缓存

删除 Maven 本地存储库中的缓存文件。这将强制 Maven 重新下载依赖项，并可能解决问题。使用以下命令：

mvn clean

3. 检查 pom.xml 文件

仔细检查 pom.xml 文件中的依赖项声明，确保没有重复或不必要的依赖项。还可以使用 Maven 依赖项分析工具，例如 mvn dependency:tree，以查看项目的依赖关系树。

4. 更新 Maven 版本

确保使用最新版本的 Maven。较旧的 Maven 版本可能存在导致此问题的已知问题。

5. 排除冲突的依赖项

如果某些依赖项版本不兼容，可能会导致冲突。尝试排除冲突的依赖项并使用兼容的版本。使用以下语法：

<dependency>
  <groupId>...</groupId>
  <artifactId>...</artifactId>
  <version>...</version>
  <exclusions>
    <exclusion>
      <groupId>...</groupId>
      <artifactId>...</artifactId>
    </exclusion>
  </exclusions>
</dependency>

6. 使用 assembly 插件的 excludeArtifactIds 配置

使用 assembly 插件的 excludeArtifactIds 配置可以排除不需要的工件。这可以防止 Maven 复制特定的类。例如：

<configuration>
  <archive>
    <manifest>
      ...
    </manifest>
    <manifestEntries>
      ...
    </manifestEntries>
    <fileSet>
      ...
    </fileSet>
    <excludeArtifactIds>
      <excludeArtifactId>groupId:artifactId</excludeArtifactId>
    </excludeArtifactIds>
  </archive>
</configuration>