java同时使用两个不同版本的jar包，基于maven-shade-plugin，非自定义类加载器方法

原创已于 2025-05-15 11:43:52 修改 · 1.1k 阅读

16 ·

CC 4.0 BY-SA版权

文章标签：

#java #jar #maven

于 2025-03-27 18:55:25 首次发布

技术需求

我们工程里有一个在开源基础上停留在将近十年前的魔改私库，最近有新需求开发，多角度论证后决定依赖最新版本，不在私库上增加工作量苦苦挣扎了。所以我们需要在同一个java进程内同时运行两个不同版本的jar包。

我们新建一个module叫example来开发新的功能，使新旧版本至少在module上是隔离的。

技术调研-自定义类加载器

大模型给的回答是类加载器和maven-shade-plugin。在新的module的pom文件声明对应的新版本，很顺利的基于新版本完成编码。问题出现在运行的时候，清楚的看到getCodeSource日志打出的路径是引用旧版本的jar包。java运行时输出类的加载路径，参考如下代码

                CodeSource codeSource = clazz.getProtectionDomain().getCodeSource();
                // 获取 JAR 文件路径
                URL location = codeSource.getLocation();
                log.info(new File(location.toURI()).getAbsolutePath());

个人感觉用类加载灵活性更强，在同一个类里面也可以自由引用。开启URLClassLoader和ClassLoader破坏双亲委派通过自定义类加载器兼容两个版本的踩坑之路。在大模型的辅助下，大部分模块代码快速完成，传入的父类加载器要正确等，大模型帮忙完成了面向字符串繁琐的反射调用，虽然很不优雅，但灵活啊，继续编码。解决了各种遇到的问题后，有个方法一直报参数类型不匹配。想不通啊想不通，折腾一天后，打算试试maven-shade-plugin重定义包路径。

maven-shade-plugin

按照网上的教程还有大模型没多久把程序运行起来了。但是过程也很别扭，定义了一个sshd-shaded模块后，idea一直找不到代码，install报错。按照教程单独maven运行sshd-shaded的package得到一个jar包，将jar添加到Project Structure的 Libraries后，整个项目才可以正常运行。

如果是只有我一个人的临时项目这样做繁琐点可以接受。但是其它开发和流水线要怎做难住我了。后来又花了三天时间边开发边优化，实现通过在同一个工程用install可以编译，不改变原来的构建流程。关键点在sshd-shaded的pom设置maven-shade-plugin。example模块正常引入sshd-shaded的声明就可以。当example内冲突模块的import都要增加shade前缀，例如import org.apache.sshd.server.SshServer;变成import shade.org.apache.sshd.server.SshServer;

下面关键的是sshd-shaded的完整示例，其实来来回回就这个pom但大模型和教程各种折腾了好几天才达到想要的结果，老老实实看官方文档可能快一点。

<?xml version="1.0"?>
<project
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
        xmlns="http://maven.apache.org/POM/4.0.0">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>example</artifactId>
        <version>develop-SNAPSHOT</version>
        <relativePath>../</relativePath>
    </parent>
    <artifactId>sshd-shaded</artifactId>
    <name>sshd-shaded</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <sshd.proxy.version>2.15.0</sshd.proxy.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.apache.sshd</groupId>
            <artifactId>sshd-common</artifactId>
            <version>${sshd.proxy.version}</version>
        </dependency>

        <dependency>
            <groupId>org.apache.sshd</groupId>
            <artifactId>sshd-core</artifactId>
            <version>${sshd.proxy.version}</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.4</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <createDependencyReducedPom>false</createDependencyReducedPom>
                            <keepDependenciesWithProvidedScope>true</keepDependenciesWithProvidedScope>
                            <artifactSet>
                                <includes>
                                    <include>org.apache.sshd:sshd-core</include>
                                    <include>org.apache.sshd:sshd-common</include>
                                </includes>
                            </artifactSet>
                            <relocations>
                                <relocation>
                                    <pattern>org.apache.sshd</pattern>
                                    <shadedPattern>shade.org.apache.sshd</shadedPattern>
                                </relocation>
                            </relocations>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

依赖排除

代码是正常运行了，但查看依赖包会发现带有2.15.0的sshd-* 的jar包，实际我们是不需要的，依赖进来兴许那天和低版本冲突。解决的办法比较简单在产生依赖的pom排除依赖。mvn dependency:tree一把分析依赖树。
或者在引入shade的地方声明排除依赖。

        <dependency>
            <groupId>com.example</groupId>
            <artifactId>sshd-shaded</artifactId>
            <version>${project.version}</version>
            <exclusions>
                <exclusion>
                    <groupId>org.apache.sshd</groupId>
                    <artifactId>sshd-common</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>org.apache.sshd</groupId>
                    <artifactId>sshd-core</artifactId>
                </exclusion>
            </exclusions>
        </dependency>