外观
03 - 类加载:身份、初始化与故障证据
基线:Java 虚拟机规范(JVMS)17、Java 语言规范(JLS)17;本地以 HotSpot(JVM 的一种实现)8/17 对照。Web 容器的加载策略需按具体容器理解,不能推广为 JVM 规则。
阅读指引
- 本文定位:执行链中的类型身份与初始化环节,解释“同名类不一定是同一类型”“加载成功不等于初始化成功”。
- 前置阅读:09 类文件与字节码提供常量池、符号引用与调用契约;01 内存布局区分元空间与 Class 镜像。
- 后续阅读:02 对象创建与分配从类初始化进入实例构造与分配,避免把两种初始化协议混为一谈。
- 学习目标与排障:能按定义加载器、链接阶段和初始化状态定位故障;需要现场确认类型来源和方法时,读 B Arthas的 sc/sm/loader 观测边界。
摘要
JVM 要使用一个类,先要取得它的定义、检查执行条件,再在需要时完成静态初始化。这三个环节分别对应加载、链接和初始化。加载器还参与决定类型身份:即使类名和字节完全相同,由不同加载器定义的类也可能无法互相强转。本文先建立这套基本模型,再用初始化和双加载器实验解释故障,最后讨论热部署中的卸载问题。
1. 现象:启动成功后才报类错误
类并不一定在启动时全部加载、解析和初始化。例如,某条业务路径第一次读取静态字段(对应 getstatic 字节码指令)、调用插件或解析依赖时,才会遇到相关错误。因此,启动健康检查通过,只说明它覆盖的路径可以执行,不能代替全路径测试。
排查时先判断失败发生在哪一步:寻找类、定义与验证、解析引用、静态初始化,还是应用代码的强制类型转换。错误中出现的类名相同,原因也可能不同;应保留最早的异常原因(cause)以及实际运行的 class 文件或 JAR 包来源。
2. 原理:阶段有约束,不是一次性流水线
基础入口:从源码到可调用的类
javac 把源码编译为 class 文件,java 启动的 JVM 再寻找并加载运行所需的类。class 文件保存编译后的类型定义;运行时的 Class<?> 是表示类型的 Java 对象,也称 Class 镜像。类加载器按搜索与委派规则取得类的字节,并参与创建运行时类型。JAR 包只是文件的集合,存在于磁盘上不等于其中所有类都已加载。
例如 new Order() 要使用 Order 类型,JVM 必须确保它完成适用的加载、链接和初始化。实例构造则发生在另一个层次:静态字段属于类的状态,实例字段属于每个对象的状态。类初始化通常针对同一个运行时类进行一次,构造器可以因创建多个实例而多次执行。
理解阶段时先抓住三个问题:字节从哪里来?这些字节能否安全执行、引用能否找到目标?静态初始化代码是否完成?接下来再区分验证、准备与解析。
text
加载 → 链接(验证、准备、解析)→ 初始化 → 使用
解析可以按需延后
卸载取决于可达性、实现与收集时机初始化前必须完成相应验证和准备。解析则可以提前进行(eager),也可以延迟到需要引用时进行(lazy),但错误暴露的时点要符合规范。因此,这张图表达的是阶段约束,不表示每个类都必须一次性完成所有工作。
| 阶段 | 作用 | 边界 |
|---|---|---|
| 加载/创建 | 获得表示并创建运行时类型 | 数组类由 JVM 创建,不读对应 class 文件 |
| 验证 | 检查格式与类型安全等 | 不保证应用逻辑正确 |
| 准备 | 创建静态字段并赋默认值,建立实现结构 | 不执行普通源码静态初始化器 |
| 解析 | 根据引用与加载器规则定位实体,检查访问等 | 可能在后续首次使用时失败 |
| 初始化 | 常量值赋值及执行初始化协议,适用时执行 <clinit> | final 不等于所有字段都无需执行代码 |
符号引用是 class 文件中用名称和描述符表示的类型、字段或方法引用;描述符记录字段类型或方法的参数、返回类型。解析负责把这些引用对应到运行时目标。虚分派则根据实际接收方法调用的对象,选择要执行的实现,属于另一层机制,不能用多态解释解析的全部时序。
<clinit> 是 class 文件中的类或接口初始化方法,承载需要执行的静态字段赋值、静态代码块等代码;它与实例构造器 <init> 不同。接下来讨论的是类的静态状态,而不是每个对象的构造过程。
2.1 ConstantValue 与准备阶段不要混写
static int value = 7 在准备阶段先获得默认值 0,源码中的赋值在初始化中执行。理解 static final 时,还要区分常量变量:它是以常量表达式初始化的、类型为基本类型或 String 的 final 变量。因此,static final int FIXED = 7 是常量变量,而 static final Integer BOXED = 7 不是。
ConstantValue 是 class 文件中记录字段常量值的属性。FIXED 可带有这个属性,其值也可被编译进调用方,称为常量内联。内联后的调用方直接使用自身产物中的值,不读取运行时字段,所以该访问不触发声明类初始化。常量更新后,旧调用方若没有重新编译,可能仍使用旧值。
精确时序需按 JVMS 17 §5.5/JLS 17 §12.4.2 的初始化协议理解:常量变量值的初始化在普通 <clinit> 代码前,并早于相关父类型初始化步骤。因此,不能把所有 static final 字段统一理解为“准备阶段直接赋源码中的值”。
2.2 初始化触发与不触发
先用常见表达式速查。这里说的是“这个操作本身是否触发初始化”,不表示此前该类一定尚未初始化:
| 操作 | 初始化边界 | 为什么 |
|---|---|---|
new Child() | 触发 Child 的适用初始化协议 | 创建实例前必须满足类型初始化要求;不是只执行实例构造器 |
Child.count,字段实际声明在 Parent | 触发实际声明字段的 Parent,不因这个访问本身初始化 Child | 源码写出的类型名不一定是字段声明者 |
Child.CONSTANT,常量已内联到调用方 | 不因该读取初始化声明类 | 调用方直接使用产物中的常量,不读取运行时字段 |
Child.class | 不因类字面量本身初始化 Child | 获得类型镜像与执行静态初始化是两件事 |
new Child[10] | 不因创建数组初始化元素类 Child | 创建的是数组对象,不是十个 Child 实例 |
Class.forName(name) | 默认请求初始化目标类型 | 与显式传入 initialize=false 的重载不同 |
常规 loader.loadClass(name) | 通常只加载,不保证执行初始化 | 自定义加载逻辑也应单独检查,不能与 forName 混用 |
例如父类声明 static int count = 7,子类没有声明同名字段,Child.count 访问的仍是父类字段。判断初始化对象,应看字段的实际声明者。同样,写入适用静态字段、调用静态方法,也要按实际声明成员的类或接口判断,而不是只看源码中的类型名。
掌握这些常见操作后,再看两个进阶边界:
- 初始化类时,要先按协议初始化父类,以及相关父接口中声明了默认方法(
default方法)的接口。默认方法是接口中带有实现的方法;并不是一个接口只要声明了默认方法就自动初始化。初始化接口本身也不普遍初始化所有父接口。 - 方法句柄(
MethodHandle,用于表示可调用的方法等操作)和反射调用有各自的触发条件。读取反射元信息与执行反射调用不同,不能把所有反射查询都视为必定初始化。
2.3 初始化锁、递归与失败状态
同一个运行时类有初始化同步协议。当一个线程正在初始化它时,其他需要初始化该类的线程可能等待,避免同时执行静态初始化代码。同一线程递归请求初始化这个类时,可以返回并继续当前执行;此时某些赋值还没发生,递归路径可能读到字段的默认值。初始化完成后的状态可安全发布,但以后对可变静态字段的业务读写仍需同步,见并发 03。
若 <clinit> 抛出的异常不属于 Error,通常由 ExceptionInInitializerError 包装;若本身是 Error,则不按该规则再包装。初始化失败后,类型进入错误状态(erroneous),后续主动使用可能抛出 NoClassDefFoundError。因此,第二次报错可能只是第一次初始化失败的后果,应追查首次异常。重新访问同一个 Class 不会重新执行 <clinit> 来修复它;用新的定义加载器创建类型,会形成另一个运行时身份。
跨类静态初始化中等待其他线程/外部 I/O,可能导致初始化等待甚至死锁。线程栈与首次日志比“重新加载 jar”更重要。
3. 实现:defining loader 决定类型身份
普通运行时类的身份由 二进制名称(binary name)+ 定义加载器(defining loader) 共同决定。二进制名称是 JVM 使用的类型名称,例如 java.lang.String;定义加载器是实际定义该类的加载器。文件路径相同、名称相同,都不足以证明两个运行时类是同一类型。
发起加载器(initiating loader)是发起加载请求的加载器。它可以把请求委派给父加载器,因此发起者与实际定义者可能不同。两个发起者若通过委派拿到同一个 Class,仍然共享同一类型;只有创建不同的定义身份,才会产生这里讨论的类型隔离。
运行时包边界也包含定义加载器:即使源码的 package 名相同,由不同加载器定义的类也不能自动共享包可见权限。这里的身份模型针对普通运行时类;隐藏类(不供普通按名称查找使用的类)、数组类等另有规范边界,不能一概视为可通过 loadClass 按名称取得的普通类。
3.1 默认委派与平台演进
以通常的 JDK 17 应用启动为例:
| 加载器 | 常见职责 | 不要误解为 |
|---|---|---|
| Bootstrap,启动加载器 | 定义 java.lang.Object 等核心类 | 普通应用可以随意替换的业务加载器 |
| Platform,平台加载器 | 加载其负责的平台模块中的类 | JDK 8 的扩展目录机制原样保留 |
| Application,应用加载器 | 加载通常 classpath 上的应用类 | 应用内所有框架自定义加载器的唯一来源 |
JDK 8 使用扩展加载器这一旧体系,JDK 9 的模块化改变了内置加载器与搜索边界。模块中的类也不简单地全部归平台加载器;具体来源可以通过类的 getClassLoader() 观察。该 API 对启动加载器定义的类返回 null,不是类“没有被加载”。
双亲委派中的“父”是加载器的协作关系,不是 Java 类的继承关系。标准 loadClass 的基本思路是先检查已加载缓存,再向父加载器委派;父方未找到时再尝试本加载器的 findClass。这减少基础类型被重复定义的风险。自定义业务加载器通常优先重写 findClass,只有明确的隔离需求才改变委派策略。
text
收到类名
→ 已加载缓存命中?是:返回同一个运行时类
→ 向父方委派(父为空时按实现查启动加载器)
→ 父方找到?是:返回其结果
→ 本加载器尝试 findClass
→ 找到字节并定义类型;找不到则报告查找失败这个流程是理解标准协作模式的简图,不是让所有容器照抄的插件模板。加载不等于初始化,缓存命中也不表示该类静态初始化已成功。
先用普通应用观察来源,再看第 5 节双加载器实验:
java
public final class LoaderBasicsDemo {
public static void main(String[] args) throws Exception {
System.out.println("core=" + String.class.getClassLoader());
System.out.println("application=" + LoaderBasicsDemo.class.getClassLoader());
Class<?> loaded = Class.forName("LoaderBasicsDemo", false,
LoaderBasicsDemo.class.getClassLoader());
System.out.println("same=" + (loaded == LoaderBasicsDemo.class));
}
}保存为 LoaderBasicsDemo.java,执行 javac LoaderBasicsDemo.java、java LoaderBasicsDemo。常规 JDK 17 应用下的预期输出包含 core=null、same=true;应用加载器的打印名称由实现决定,不要求输出某个固定地址。same=true 表示再次查找得到的是同一个 Class 镜像,而不是重新定义了一份类型。
需要子优先隔离时,还必须处理并行加载锁、重复定义与共享 API 边界。JDK 8 的传统 rt.jar/ext 搜索路径不能推广到模块化运行时;JDK 9+ 的 jmods 也不能当作运行时直接读取类的来源。不要用 java.* 包前缀推断唯一加载器,API 对启动加载器返回 null 也不规定所有 JVM 必须采用相同的内部表示。
双亲委派不是唯一安全屏障,也不能阻止任意 loader 定义不同副本;核心包限制、模块和加载约束共同作用。Tomcat 子优先策略带有例外,热替换 Agent 与“丢弃加载器再加载新类型”也不是一回事。
3.2 SPI/TCCL 不是神秘反向继承
SPI(Service Provider Interface,服务提供者接口)让库通过约定接口发现可替换的实现。发现实现时,除了接口本身的加载器,还需要选择能看到实现类的加载环境。TCCL(Thread Context ClassLoader,线程上下文类加载器)是线程携带的加载器引用,某些库会显式使用它寻找服务实现。
ServiceLoader 也提供接受加载器或模块层(module layer,组织一组运行时模块的结构)的入口。选择 TCCL 不必然改变所选加载器内部的默认 loadClass 委派规则。JDBC 的驱动发现与注册过程受驱动和版本影响,不能推广成所有 SPI 都打破双亲委派。
插件应把共享接口放在共同父加载器,让各插件的实现隔离。这样实现与调用方看到的是同一份接口类型;若各自定义接口,就可能得到无法互转的同名类型。隔离之后还要管理生命周期:线程的 TCCL、服务实例、缓存或回调若长期保留旧加载器,会阻止卸载。
4. 验证一:初始化事件与失败后遗症
下面的完整示例用于对照第 2 节的触发规则,可在 JDK 8/17 下编译运行。保存为 InitBoundaryDemo.java:
java
public final class InitBoundaryDemo {
static class Parent {
static final int FIXED = 7;
static int value = initialize();
static int initialize() {
System.out.println("Parent initialized");
return 9;
}
}
static class Child extends Parent {
static {
System.out.println("Child initialized");
}
}
static class Broken {
static int value = fail();
static int fail() {
throw new IllegalStateException("configuration missing");
}
}
public static void main(String[] args) throws Exception {
System.out.println("constant=" + Child.FIXED);
Parent[] array = new Parent[1];
System.out.println("array=" + array.length);
Class.forName("InitBoundaryDemo$Child", false,
InitBoundaryDemo.class.getClassLoader());
System.out.println("loaded without initialization");
System.out.println("inherited=" + Child.value);
Class.forName("InitBoundaryDemo$Child", true,
InitBoundaryDemo.class.getClassLoader());
for (int attempt = 1; attempt <= 2; attempt++) {
try {
System.out.println(Broken.value);
} catch (LinkageError failure) {
System.out.println("attempt=" + attempt + " error="
+ failure.getClass().getSimpleName());
}
}
}
}bash
javac InitBoundaryDemo.java
java InitBoundaryDemo预期 constant/array/loaded 三条先输出,再有 Parent initialized、inherited=9,然后显式初始化 Child;Broken 两次分别为 ExceptionInInitializerError、NoClassDefFoundError。这是受控教学捕获,不建议生产代码捕获 LinkageError 后继续正常业务。
5. 进阶选读:相同字节、不同定义者
这一节通过自定义加载器说明插件隔离的类型边界,需要准备两个源码文件。第 3 节的单文件例子已经足够认识加载器;只有继续研究“同名类为什么不能强转”时才需要下面的隔离实验。
保存 LoaderPayload.java:
java
public final class LoaderPayload {
public LoaderPayload() {
}
}再保存 LoaderIdentityDemo.java:
java
import java.nio.file.Files;
import java.nio.file.Paths;
public final class LoaderIdentityDemo {
static final class IsolatedLoader extends ClassLoader {
private final byte[] bytes;
IsolatedLoader(byte[] bytes) {
super(null);
this.bytes = bytes;
}
protected Class<?> findClass(String name) throws ClassNotFoundException {
if (!"LoaderPayload".equals(name)) {
throw new ClassNotFoundException(name);
}
return defineClass(name, bytes, 0, bytes.length);
}
}
public static void main(String[] args) throws Exception {
byte[] bytes = Files.readAllBytes(Paths.get("LoaderPayload.class"));
IsolatedLoader firstLoader = new IsolatedLoader(bytes);
IsolatedLoader secondLoader = new IsolatedLoader(bytes);
Class<?> first = firstLoader.loadClass("LoaderPayload");
Class<?> second = secondLoader.loadClass("LoaderPayload");
Object instance = second.getDeclaredConstructor().newInstance();
System.out.println("sameName=" + first.getName().equals(second.getName()));
System.out.println("sameClass=" + (first == second));
System.out.println("sameLoaderCached="
+ (first == firstLoader.loadClass("LoaderPayload")));
System.out.println("isInstance=" + first.isInstance(instance));
try {
first.cast(instance);
} catch (ClassCastException failure) {
System.out.println("cast=" + failure.getClass().getSimpleName());
}
}
}bash
javac LoaderPayload.java LoaderIdentityDemo.java
java LoaderIdentityDemo在 JDK 8/17 下编译运行时,将两个源码文件放在同一目录,并从包含 LoaderPayload.class 的目录启动程序。预期输出为 sameName=true、sameClass=false、sameLoaderCached=true、isInstance=false、cast=ClassCastException。
两份定义来自相同字节,但定义加载器不同,因此 second 创建的实例不属于 first 表示的类型。parent=null 仅为隔离普通应用类的教学设置,不作为生产插件加载模板;它仍能使用启动加载器定义的 Object。
6. 排障:错误类型与来源一起看
| 错误/现象 | 证据 | 下一步 |
|---|---|---|
| ClassNotFoundException | 显式查找的 name、loader 与搜索路径 | 查部署产物、模块/服务配置 |
| NoClassDefFoundError | 缺失依赖或 erroneous 类型的最早 cause | 区分找不到与初始化失败;不要求曾加载成功 |
| NoSuchMethodError / IllegalAccessError | 运行产物与调用描述符、模块及 loader | 回 09 验证契约 |
| 同名 ClassCastException | 两边的 defining loader、code source | 统一共享接口或依赖,区别 Spring 代理类型 |
| 元空间增长 | loaded/unloaded 趋势、loader 实例及到根引用链 | 分清高类生成与旧 loader 被保留 |
| 初始化卡住 | 多时点栈、初始化等待、外部依赖/循环等待 | 找初始化持有者,不只扩线程池 |
JDK 17 可使用 -Xlog:class+load=info,class+init=info,class+unload=info;JDK 8 使用 -verbose:class 或目标版本支持的 TraceClassLoading/TraceClassUnloading。旧 TraceClass* 选项的兼容性需按目标 JDK 确认。
getProtectionDomain().getCodeSource() 返回的代码来源(code source)与加载器信息可帮助定位产物,但代码来源可能为空,也不能证明字节码未被 Agent(运行时插桩代理)改写。Arthas 的 sc/classloader 命令需匹配版本与权限,安全边界见 07与 B。
7. 卸载与工程取舍
卸载是 JVM 移除不再需要的运行时类型及相关元数据的过程。普通类能否卸载,与定义加载器是否可被回收紧密相关。可达性表示是否还能从垃圾收集的根沿引用链到达对象;Class 镜像、实例、线程上下文和 JVM 内部结构的保留都会影响这条引用链。
例如旧线程的 TCCL 仍指向旧加载器,仅清空业务代码中的局部加载器变量并没有切断所有保留路径。即使满足卸载的必要条件,也不保证马上卸载,还受收集器、配置和回收周期影响。隐藏类等有不同生命周期,不能一概套用“加载器内所有类同步卸载”。
热部署验收应检查旧线程退出、TCCL 恢复、监听器注销、缓存/服务注册清理和 loaded/unloaded 趋势。仅把局部 loader 置 null 或调用 System.gc 不能证明资源释放;元空间增长也不全是 loader 泄漏,动态生成类和合法长期增长都需区分。
跨专题应用见Spring 09 代理创建、Spring 19 启动分段。后续进入 02 对象构造和 05 类层次与 JIT 假设。
实验结果与参考资料
实验环境:Windows x64 10.0.26200、i7-10700(16 逻辑 CPU),分别用 OpenJDK 17+35-2724 与 Oracle 1.8.0_191-b12 对应 javac 编译。InitBoundaryDemo、LoaderIdentityDemo 均退出码 0,事件顺序与布尔值符合正文预期。
InitBoundaryDemo 两次错误分别为 ExceptionInInitializerError、NoClassDefFoundError;17 的 class+load/class+init 日志还记录了 Parent/Child 的加载与初始化事件。LoaderIdentityDemo 同名 true、同 Class false、同 loader 缓存 true、isInstance false,强转为 ClassCastException。
实验通过不表示 ConstantValue 准备/初始化时点由这段输出独立证明:该时序依据 JVMS §5.5,调用方常量内联则由产物与触发规则解释。示例不覆盖真实热部署、加载器回收或初始化死锁,不能推导必然卸载时刻。
名词解释
| 名词 | 本文中的含义 |
|---|---|
| 链接 | 验证、准备和解析等工作,使运行时类型满足执行与引用契约。 |
| 符号引用 | 用名称和描述符表达的类型、字段或方法引用,运行时按规则确定目标。 |
| 定义加载器(defining loader) | 实际定义某个普通运行时类的加载器,与类名共同决定类型身份。 |
| 双亲委派 | 加载器优先向父方委派再尝试自身查找的常用协作模式,不是类继承。 |
| TCCL | 线程上下文类加载器,部分框架/SPI 用它查找调用环境中的类型和资源。 |
| clinit | class 文件中的类或接口初始化方法名称,不是实例构造器 init。 |