如何在Maven生成的WAR文件中覆盖依赖JAR文件？

我来给你几个实用的解决方案，完美适配你这种不想传Maven仓库、要强制覆盖WAR里已有依赖JAR的场景：

问题回顾 #

我一直在将一些修补后的JAR文件复制到WAR文件中，以便在不上传到Maven仓库的情况下测试修复后的JAR。使用maven-war-plugin时，仅当目标JAR不存在时才会完成复制，但不会覆盖已存在的JAR。这些JAR属于多个我无法控制的依赖，数量不定，且测试前我无法在Nexus中替换它们，也无法将其放置在本地Maven仓库中。

方法1：直接配置maven-war-plugin强制覆盖 #

这是最直接的方式，只要在war插件的webResources配置里开启overwrite=true，就能让本地修补的JAR强制替换WAR里已有的同名JAR：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.2</version> <!-- 建议使用最新稳定版 -->
    <configuration>
        <webResources>
            <resource>
                <!-- 这里填你存放修补后JAR的本地目录 -->
                <directory>${project.basedir}/patched-jars</directory>
                <!-- 指定复制到WAR的WEB-INF/lib目录 -->
                <targetPath>WEB-INF/lib</targetPath>
                <!-- 匹配所有JAR文件，批量处理 -->
                <includes>
                    <include>*.jar</include>
                </includes>
                <!-- 核心配置：开启强制覆盖 -->
                <overwrite>true</overwrite>
            </resource>
        </webResources>
    </configuration>
</plugin>

打包时，Maven会自动把你本地修补的JAR覆盖掉WAR中WEB-INF/lib里的同名文件，完全不用管原依赖的来源。

方法2：用maven-resources-plugin提前替换依赖目录 #

如果war插件的配置不够灵活，你可以先用资源插件把修补JAR复制到项目的临时依赖目录，再让war插件打包这个目录，同样能实现覆盖：

<!-- 第一步：把修补JAR复制到项目的依赖输出目录，强制覆盖 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.1</version>
    <executions>
        <execution>
            <id>copy-patched-jars</id>
            <phase>process-resources</phase> <!-- 在打包前执行 -->
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/dependency</outputDirectory>
                <resources>
                    <resource>
                        <directory>${project.basedir}/patched-jars</directory>
                        <includes>
                            <include>*.jar</include>
                        </includes>
                        <overwrite>true</overwrite>
                    </resource>
                </resources>
            </configuration>
        </execution>
    </executions>
</plugin>

<!-- 第二步：让war插件打包这个已经替换好的依赖目录 -->
<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>3.3.2</version>
    <configuration>
        <webResources>
            <resource>
                <directory>${project.build.directory}/dependency</directory>
                <targetPath>WEB-INF/lib</targetPath>
                <includes>
                    <include>*.jar</include>
                </includes>
            </resource>
        </webResources>
    </configuration>
</plugin>

这种方式适合需要在打包前做额外处理的场景，比如你还要对JAR做其他操作。

方法3：精准替换指定依赖（适合已知坐标的情况） #

如果你清楚每个修补JAR对应的原依赖坐标，可以用dependency插件精准替换，避免误覆盖其他文件：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <version>3.6.0</version>
    <executions>
        <execution>
            <id>replace-patched-jars</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>copy</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <!-- 每个修补的JAR对应一个artifactItem -->
                    <artifactItem>
                        <groupId>com.example</groupId> <!-- 原依赖的groupId -->
                        <artifactId>some-dependency</artifactId> <!-- 原依赖的artifactId -->
                        <version>1.0.0</version> <!-- 原依赖的版本 -->
                        <type>jar</type>
                        <overWrite>true</overWrite>
                        <outputDirectory>${project.build.directory}/WEB-INF/lib</outputDirectory>
                        <destFileName>some-dependency-1.0.0.jar</destFileName> <!-- 要替换成的文件名，和原依赖一致 -->
                        <file>${project.basedir}/patched-jars/some-dependency-patched.jar</file> <!-- 本地修补JAR的路径 -->
                    </artifactItem>
                    <!-- 可以添加更多artifactItem处理多个修补JAR -->
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>

几个关键注意事项 #

• 文件名必须一致：修补后的JAR文件名要和原依赖的完全相同（比如原依赖是foo-2.0.jar，修补后也得叫这个名字），否则WAR里会同时存在两个JAR，容易引发类加载冲突。
• 测试后清理配置：这些都是临时测试用的配置，正式打包前记得移除，避免把修补JAR误传到生产环境。
• 批量处理选方法1：如果修补JAR数量不定、没法逐个对应坐标，方法1的通配符批量处理是最高效的。

内容的提问来源于stack exchange，提问作者Carlos Gómez