同一个类被加载两次:ClassLoader 冲突让 instanceof 失效

报错写着 Bar cannot be cast to Bar,两个类名一模一样却不是同一个类。根因是两个 ClassLoader 各加载了一份。这篇讲清 JVM 判定类身份的依据、现场怎么用 Arthas 定位、以及四类常见来源。

java.lang.ClassCastException: com.example.spi.Plugin cannot be cast to com.example.spi.Plugin——第一次见到这个报错的人会以为日志坏了,类名明明一样。实际上 JVM 判定一个类的身份,靠的是「全限定名 + 定义它的类加载器」这个二元组,两者有一个不同,就是两个完全无关的类。

类身份是怎么判定的

在 JVM 里,Class 对象的相等性由加载它的 ClassLoader 参与决定。instanceof、强制类型转换、Class.isAssignableFrom 都遵循这个规则。所以当父加载器和子加载器各有一份 Plugin.class,子加载器加载出来的实例,在父加载器加载的接口看来就是「另一个类型」。

双亲委派本来是为了避免这件事,但现实里被打破的地方很多:SPI 与线程上下文类加载器、插件化/隔离容器、shade 重定位、热部署、以及 Web 容器把依赖分散在不同 lib 目录。

现场确认:三个 ClassLoader 是谁

先别猜,把三方的类加载器打出来:

Object instance = pluginFactory.create();
log.info("instance class={} loader={}",
    instance.getClass().getName(), instance.getClass().getClassLoader());
log.info("expect   class={} loader={}",
    Plugin.class.getName(), Plugin.class.getClassLoader());
log.info("instanceOf={}", instance instanceof Plugin);

两个 loader 的 toString 不一样,问题就定性了。线上不方便改代码时用 Arthas:

sc -d com.example.spi.Plugin
classloader -t
classloader -a | grep com.example

sc -d 输出里的 classLoaderHash 是判断依据,classloader -t 能看到父子层级关系。如果同一个类名在 classloader -a 的结果里出现在两个不同的 hash 下,冲突确认。JVM 层面还可以用 jcmd <pid> VM.classloader_stats 看加载器数量是否异常增长。

四类常见来源

依赖被 shade 进不同 jar。 两个中间件各自把同一个公共库 relocate 或直接打进 fat jar,应用 classpath 上于是有两份同名类。

Spring Boot fat jar 与外部 lib 并存。 应用以 java -jar 启动,同时又用 -Dloader.path 或 -cp 挂了一个包含公共 API 的外部目录,BOOT-INF/lib 和外部目录里的那份谁先被加载取决于配置,很容易出现「接口在父加载器、实现在子加载器」。

Servlet 容器分层。 Tomcat 的 common/lib、shared/lib、WEB-INF/lib 是三个不同的加载器层级,把同一个 SDK 放错位置就会出现「容器里能用、代码里 cast 失败」。

命名空间迁移残留。 javax.* 与 jakarta.* 同时存在于 classpath,两套 API 各自加载,表现为注解不生效、instanceof 为 false,排查时却完全看不到异常。

这类问题的信号很弱:编译能过、启动不报错,只有运行到某个分支才炸,而且往往要等某个插件被加载才触发。

修复策略

按代价从低到高:

  1. 统一版本。先用依赖树把重复的坐标找出来,能排掉就排掉:
mvn -q dependency:tree -Dincludes=com.example:plugin-api
for j in $(find . -name '*.jar'); do
  unzip -l "$j" 2>/dev/null | grep -q 'com/example/spi/Plugin.class' && echo "$j"
done
  1. 把 API 交给运行环境。公共接口用 provided 作用域,由容器或父加载器统一提供。
  2. 入口统一。插件体系里所有类都通过 Class.forName(name, false, expectedLoader) 加载,显式指定加载器,把「谁加载」这件事从隐式变显式,至少不会静默错位。

适用边界与常见坑

  • instanceof 失效只是最表层的症状。静态初始化块被执行两次,会带来重复注册、连接池翻倍、定时任务跑两遍,这些比类型转换失败更难发现。
  • 不要用 getClass().getName().equals(...) 来「绕过」判断,那只是把错误静默掉,真正的问题还在。
  • 热部署环境里静态字段或 ThreadLocal 持有旧 ClassLoader,会让整个加载器无法回收,最终表现为 Metaspace 持续上涨。
  • 隔离是解法也是坑:给自己造一个子加载器确实能解决冲突,但从此跨加载器的对象传递只能走接口或序列化,团队要接受这个约束。
查看「Java 与 JVM」全部文章 →

同分类文章

查看 0 评论 0

评论

正在加载评论…

留言提交后自动审核:正常内容立即显示,含敏感信息的会转人工复核。

同一个类被加载两次:ClassLoader 冲突让 instanceof 失效 - 起航社区