JVM存同名称不同版本Jar时类加载机制及Wildfly版本选择问题

默认类加载规则 #

• 标准双亲委派模型下，类的唯一性由「类加载器实例 + 类的全限定名」共同决定，同一个类加载器下，全限定名相同的类只会被加载一次。
• 类加载触发时机是在该类被首次主动引用的时候，不是等到运行时分支执行的时候。当加载调用方类（比如包含if-else逻辑的类，或者A2、A3类）时，类加载器就会按classpath扫描顺序查找依赖的类，找到第一个匹配的Jar包后就加载对应的类，后续同全限定名的类会被直接忽略。

不同场景的具体行为 #

场景1：同个调用类的if-else分支调用不同版本方法 #

你的写法本身无法实现分支切换版本的效果：

// 导入的类全限定名是固定的
import com.xxx.A1;
if (condition) {
    A1.create(); // 无论走哪个分支，用的都是类加载器首次加载的A1版本
} else {
    A1.create();
}

类加载阶段就会确定使用的A1版本，不会根据运行时分支动态切换，也不会同时加载两个版本的A1类。

场景2：A2依赖10.2.3版本、A3依赖8.18.0版本 #

如果用同一个类加载器加载A2、A3和两个版本的A1 Jar，结果依旧是只有第一个被扫描到的A1版本会被加载，A2和A3调用的都是同一个版本的A1类，不存在同时加载两个版本的情况。
加载结果不是完全随机，而是由Jar包的扫描顺序决定，不同环境下扫描规则不同就会出现部分环境正常、部分环境加载错误的问题。

JBoss/Wildfly环境的加载规则 #

WEB-INF/lib下的Jar包扫描顺序没有JVM级别的统一规范，不同版本的Wildfly规则不同：

• 部分旧版本按Jar文件名的字典序排序加载
• 部分版本按文件系统返回的文件列表顺序加载（不同操作系统、不同文件系统的返回顺序存在差异）
• 少数版本会按Jar包的最后修改时间排序加载
  这就是相同配置在不同环境表现不一致的核心原因。

正确加载指定版本Jar的方案 #

• 最优方案：统一依赖版本，从根源避免同全限定名的类多版本共存，这是最稳定无副作用的解决方案。
• 必须共存时的隔离方案：自定义类加载器，每个版本的A1 Jar用独立的类加载器加载，利用「类加载器不同则类不同」的特性实现版本隔离，给A2、A3分别指定对应的类加载器加载依赖的A1版本即可。
• Wildfly环境适配方案：编写jboss-deployment-structure.xml配置文件，将两个版本的A1 Jar定义为独立的JBoss模块，分别给A2、A3所在的模块配置对应版本的A1依赖，利用容器自带的模块隔离能力实现版本正确加载。
• 临时 workaround：手动调整classpath中Jar包的顺序，把需要优先加载的版本放在classpath最前面，该方案兼容性差，仅适合临时验证使用。

内容的提问来源于stack exchange，提问作者RahulNans