本文探讨了在使用maven assembly plugin打包java项目时，如何解决自定义类与依赖库中同名类冲突的问题。当尝试用自己的实现覆盖现有闭源库的类时，maven assembly plugin默认会跳过重复文件。通过配置`archiverconfig`中的`duplicatebehavior`为`add`，并确保使用`maven-assembly-plugin` 3.4.2或更高版本，可以强制插件包含自定义类，从而实现对库类的有效覆盖，确保最终可执行jar包按预期运行。
理解Maven Assembly Plugin的类覆盖挑战
在Java开发中，有时我们需要对现有库（尤其是闭源产品）的特定功能进行扩展或修改。一种常见做法是反编译、修改并重新编译相关类，然后将其作为自定义实现引入项目。在IDE环境中，由于其灵活的类路径管理机制，通常可以轻松地让自定义类（即使与库中的类同名）优先加载，从而实现覆盖。
然而，当使用Maven Assembly Plugin将项目打包成一个可独立运行的JAR（例如jar-with-dependencies）时，开发者可能会遇到一个问题：插件在处理依赖项时，会默认跳过与已添加文件同名的自定义类，并输出类似already added, skipping的警告。这意味着自定义的覆盖类未能被包含到最终的JAR包中，导致运行时仍然加载原始库中的类。这种行为是由于插件在构建归档文件时，其内部的Plexus Archiver默认的重复文件处理策略所致。
解决方案：配置duplicateBehavior
要解决Maven Assembly Plugin在打包时跳过重复文件的问题，我们需要显式地修改其处理重复文件的行为。这可以通过在插件配置中添加archiverConfig块，并设置duplicateBehavior参数来实现。
duplicateBehavior参数定义了当遇到归档文件中存在同名条目时的处理方式。默认情况下，它可能设置为跳过（例如skip或隐含的跳过行为），导致自定义类被忽略。通过将其设置为add，我们指示插件即使存在同名文件，也尝试将其添加到归档中。在大多数情况下，这意味着后添加的文件（通常是我们的自定义类）将覆盖或替换掉之前添加的同名文件，从而实现我们期望的类覆盖效果。
立即学习“Java免费学习笔记（深入）”；
以下是具体的Maven Assembly Plugin配置示例：
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<version>3.4.2</version> <!-- 确保使用3.4.2或更高版本 -->
<configuration>
<archive>
<manifest>
<mainClass>MyLittleLauncher</mainClass> <!-- 替换为你的主类 -->
</manifest>
</archive>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
<archiverConfig>
<!-- 关键配置：强制添加重复文件，实现覆盖 -->
<duplicateBehavior>add</duplicateBehavior>
</archiverConfig>
</configuration>
<executions>
<execution>
<id>make-assembly</id> <!-- 随意命名，用于区分执行 -->
<phase>package</phase> <!-- 在打包阶段执行 -->
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>在上述配置中：
-
maven-assembly-plugin 和3.4.2 ：指定了要使用的Maven Assembly Plugin及其版本。 ：插件的配置块。 和 ：用于配置JAR包的清单文件，包括指定主类 ，确保JAR包可执行。 ：指定了要使用的打包描述符，jar-with-dependencies会创建一个包含所有依赖的单一JAR。 ：这是解决问题的关键配置块。 -
add ：此设置强制Plexus Archiver在遇到重复文件时，不是跳过，而是尝试将其添加进去。在打包过程中，这通常意味着后处理的文件（我们的自定义类）将有效覆盖或替换掉之前处理的同名文件（原始库类）。
版本兼容性注意事项
非常重要的一点是，确保你使用的maven-assembly-plugin版本是3.4.2或更高版本。 早期版本的插件（例如2.2-beta5，这可能是某些Maven环境中的默认版本）可能存在bug，或者不支持duplicateBehavior配置，导致即使设置了也无法生效。更新到最新稳定版本可以避免潜在的问题，并确保duplicateBehavior配置能够按预期工作。
总结
通过在Maven Assembly Plugin的配置中明确设置archiverConfig的duplicateBehavior为add，并配合使用3.4.2或更高版本的插件，我们可以有效解决在打包过程中自定义类无法覆盖依赖库中同名类的问题。这一策略使得开发者能够灵活地对现有Java库进行定制和扩展，并生成功能完整、按预期运行的自包含JAR包。在进行此类覆盖操作时，务必充分测试以确保所有功能均符合预期，并注意可能存在的兼容性问题。
