java类加载器隔离机制通过“全限定名+classloader实例”唯一标识类，使不同版本同名类共存；需配合接口抽象、避免跨加载器静态引用，并辅以shaded jar等轻量方案规避冲突。
Java 类加载器隔离机制本身不“解决”版本冲突，而是让不同版本的同名类可以共存——关键在于 JVM 认为“一个类的唯一性 = 全限定名 + 加载它的 ClassLoader 实例”。只要两个版本的类由不同的 ClassLoader 实例加载，JVM 就把它们当作完全独立的类型，互不干扰。
靠隔离，不是靠覆盖
传统依赖管理（比如 Maven）只能把一个版本放进 classpath，结果往往是旧代码调用新方法时报 NoSuchMethodError，或者新代码用到旧类时抛 IncompatibleClassChangeError。ClassLoader 的思路是“各用各的”：
- 插件模块用自己独立的 URLClassLoader 加载专属 JAR，含自己版本的 Guava、POI 等
- Web 应用在 Tomcat 中由 WebAppClassLoader 加载
/WEB-INF/lib下的库，与$CATALINA_HOME/lib物理隔离 - OSGi 或自定义 ClassLoader 配合接口契约，模块之间只依赖抽象（如
ExcelProcessor），不感知具体实现
必须配合接口和调用边界
光换 ClassLoader 不够，否则静态引用、线程上下文或硬编码加载器容易引发泄漏：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 不能让 A 模块的类直接
new B模块的实现类——要用反射或统一接口工厂 - 避免在已加载类中访问跨 ClassLoader 的静态字段或调用其静态方法
-
Thread.currentThread().setContextClassLoader()只影响后续Class.forName()等委托行为，不影响MyClass.class.getClassLoader()这种硬绑定
更轻量的替代方案（多数业务项目首选）
定制 ClassLoader 成本高、易出错。更务实的做法是提前规避冲突：
-
Shaded Jar + 包重命名：用 Maven Shade Plugin 把 Guava 重定位成
com.yourapp.shaded.guava，彻底脱离原始包名空间 - jarjar 工具：在打包前批量改写字节码中的内部引用，适合嵌入式或 SDK 场景
-
依赖收敛 + exclusion：用
mvn dependency:tree -Dincludes=groupId:artifactId定位冲突源，显式排除低版本传递依赖
排查与验证手段
运行时确认是否真隔离成功，不能只看编译通过：
- 加 JVM 参数
-verbose:class，观察报错类究竟从哪个 JAR 加载 - 打印类的 ClassLoader：
MyClass.class.getClassLoader()，对比不同模块实例是否不同 - 检查关键类是否被重复加载或加载错位，尤其注意
NoClassDefFoundError和ClassNotFoundException的根源
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
