类加载的双亲委派:从 Bootstrap 到自定义 ClassLoader
问题背景:编译通过,运行时却找不到类
插件化、热部署和依赖冲突场景里,NoClassDefFoundError、ClassNotFoundException 和 LinkageError 往往在启动之后才出现。更隐蔽的情况是同一个类名在 classpath 出现了两份:代码能编译,运行时却报 ClassCastException,提示两个看起来完全相同的类不能互转。
这不是 JVM “找错了文件”,而是因为类在 JVM 中的身份由“全限定名 + 定义它的类加载器”共同决定。同一个 com.example.Plugin 字节码,被两个不同的 ClassLoader 分别 defineClass,就会产生两个互不相干的 Class 对象。理解双亲委派,本质上是在理解两件事:字节码由谁负责查找,以及找到之后还要不要先问父加载器。
类加载的生命周期与初始化边界
一个类从字节码变成可用类型,要经历加载、验证、准备、解析、初始化和使用,最后才可能被卸载。加载阶段由 ClassLoader 完成,验证、准备、解析主要由 JVM 主导,其中解析可以推迟到首次使用之前。
准备阶段会为静态字段分配内存并设置零值;static final 的编译期常量会在准备阶段通过 ConstantValue 属性直接赋值。初始化阶段才执行 <clinit>,包括静态字段的显式赋值和静态代码块。常见的初始化触发点有:
- 使用
new创建实例,或访问、修改非编译期常量的静态字段; - 调用静态方法;
- 通过反射调用,例如
Class.forName(name, true, loader); - 初始化子类时,先初始化父类。
注意,访问 static final int MAX = 10 这类编译期常量时,常量会被内联进调用方字节码,不一定会触发定义类的初始化。这个差异在依赖静态代码块注册资源的框架里很容易踩到。
加载阶段并不要求一次性把类文件读进内存,ClassLoader 可以从目录、JAR、网络甚至运行时生成的字节数组获取内容;defineClass 负责把字节数组转成 JVM 内部的 Class,而“从哪里取字节码”是加载器自己的策略。验证阶段会检查魔数、版本号、字节码语义和符号引用,准备阶段只分配静态存储,不执行 Java 代码;真正可能抛异常的业务逻辑在初始化阶段才运行。
双亲委派:loadClass 的查找顺序
JDK 9 之后,常见的委派层级是 Bootstrap、Platform、Application,再到业务自定义的 ClassLoader。Bootstrap 负责 java.lang.* 等核心类,通常由虚拟机实现,String.class.getClassLoader() 返回 null;JDK 8 则对应 Bootstrap、Extension、Application 三层。
ClassLoader.loadClass 的默认逻辑可以概括为:
- 先查已加载缓存
findLoadedClass; - 有父加载器就调用
parent.loadClass,没有父加载器则尝试 Bootstrap; - 父加载器都找不到,才调用自身的
findClass; - 需要解析时调用
resolveClass。
因此默认策略是“父优先”,而不是“子优先”。这样既能避免核心类被业务同名类替换,也能避免同一个类被重复加载。但双亲委派不是语言级的强制规定,它只是 loadClass 的默认实现,子类完全可以覆盖。
这套顺序也解释了为什么 java.lang.Object 不能被同名类替换:应用类加载器即使在自己的 classpath 上看到 java/lang/Object.class,也会先交给 Bootstrap。JDK 9 之后模块边界进一步收紧,defineClass 也不允许把类定义到 java.* 包中;某些框架通过 Java Agent 或 -Xbootclasspath/a 做增强,属于受控的例外,不应成为常规做法。
一个经典例外是线程上下文类加载器(Thread Context ClassLoader,TCCL)。JDBC 的 java.sql.Driver 接口由 JDK 自带加载器加载(JDK 8 为 Bootstrap,JDK 9 及以上为 Platform),具体驱动实现却在应用 classpath 上。父加载器看不到子加载器里的实现,于是 ServiceLoader 通过 Thread.currentThread().getContextClassLoader() 打破可见性边界。使用 TCCL 时必须在 finally 中恢复原值,否则线程池中的后续任务会继承错误的类加载器。
自定义 ClassLoader 的代码与观测命令
下面这个加载器只覆盖 findClass,把类名映射到磁盘目录,并复用应用类加载器作为父加载器:
public final class PathClassLoader extends ClassLoader {
private final Path root;
public PathClassLoader(Path root) {
super(PathClassLoader.class.getClassLoader());
this.root = root;
}
@Override
protected Class<?> findClass(String name) throws ClassNotFoundException {
Path file = root.resolve(name.replace('.', '/') + ".class");
try {
byte[] bytes = Files.readAllBytes(file);
return defineClass(name, bytes, 0, bytes.length);
} catch (IOException e) {
throw new ClassNotFoundException(name, e);
}
}
}
假设插件类 demo.Plugin 不在应用 classpath,只在 /opt/plugins/demo 下,可以这样加载:
ClassLoader loader = new PathClassLoader(Path.of("/opt/plugins/demo"));
Class<?> type = Class.forName("demo.Plugin", true, loader);
Object plugin = type.getDeclaredConstructor().newInstance();
如果 demo.Plugin 同时存在于应用 classpath,父加载器会先命中,findClass 根本不会执行。这正是双亲委派在起作用。确实需要“子优先”时,只能重写 loadClass,并显式排除 java.* 等必须以父加载器为准的包;这类改动风险很高,不能顺手为之。
defineClass 返回的 Class 还没有链接和初始化;如果同一个加载器再次定义同名类,JVM 会抛出 LinkageError,因此自定义加载器必须依赖 loadClass 的已加载缓存,而不是绕过它直接调用 findClass。需要并行加载多个类时,还要调用 registerAsParallelCapable(),否则 loadClass 会退化为类加载器级别的串行锁。
观测类加载行为可以用:
java -verbose:class -cp /tmp/demo Demo /tmp/plugin | grep demo.Plugin
java -Xlog:class+load=info -Xlog:class+unload=info \
-XX:MaxMetaspaceSize=256m -cp /tmp/demo Demo /tmp/plugin
jcmd <pid> VM.classloader_stats
jmap -clstats <pid>
-Xlog:class+load=info 适用于 JDK 9 及以上;JDK 8 可以用 -verbose:class 或 -XX:+TraceClassLoading。jmap -clstats 能列出每个类加载器加载的类数量和占用,适合排查动态生成类导致的 Metaspace 增长。
实践建议与踩坑
- 优先只重写
findClass。loadClass已经处理了缓存、父委派和并行加载锁;直接覆盖容易破坏双亲委派,也会遇到重复defineClass的LinkageError。 - 区分
Class.forName与loadClass。Class.forName(name)默认初始化类,ClassLoader.loadClass默认不初始化。框架扫描类时应使用Class.forName(name, false, loader),避免提前触发静态代码块。 - 动态加载器要能卸载。 类卸载要求它的定义加载器、类实例和
Class对象都不可达。若静态缓存、线程池或 TCCL 仍持有插件对象,加载器就无法回收,最终表现为 Metaspace OOM。使用URLClassLoader时记得close()。 - 不要用 TCCL 做长期状态。 线程池复用线程时,未恢复的上下文类加载器会污染后续任务,典型现象是“第一次请求正常,后续请求找不到驱动或 SPI 实现”。
- 自定义加载器要限权。 能定义任意字节码的加载器等于拥有代码执行能力,插件来源、签名校验和包名隔离都要在加载之前完成,不能只依赖双亲委派。类加载器隔离不是安全沙箱,不能替代权限校验。
- 点赞
- 收藏
- 关注作者
评论(0)