1 / 4概念
Runtime: Class Loading
类加载是 JVM 把二进制变成类型的第一步,也是排查 ClassNotFoundException、依赖版本冲突和元空间泄漏的入口。判断标准不是背得出阶段名,而是能说清一个类挂在哪个加载器上、什么时候被初始化、失败时卡在哪一步。加载器本身也是可达对象,它会连着它加载过的所有类一起存活或一起被回收。
1 概念
1.1 一句话定义
class 文件是 JVM 的二进制契约,类加载是把这份契约变成可用 Class 对象的过程。加载器负责找到字节,链接负责校验与准备,初始化负责执行静态初始化逻辑。
1.2 它解决什么问题
- 平台无关:编译产物不绑定指令集,同一份字节码在各系统上由各自的 JVM 执行。
- 按需加载:类型在第一次主动使用时才被加载,启动不必读全量 class,间接缩短冷启动。
- 命名空间隔离:不同加载器可以同时持有同名类,插件之间互不覆盖。
- 动态性:反射、动态代理、
MethodHandle与invokedynamic都建立在运行期可解析的类型上。 - 可替换:加载器被丢弃后,它加载的类可整体卸载,热部署与脚本引擎依赖这一点。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 对象布局、垃圾回收与堆参数 | Memory and GC |
| 解释执行、JIT 与 safepoint | JIT and Threads |
| 依赖冲突的工程化解法 | Build and Dependencies |
| 操作系统页表与虚拟内存 | Memory Management |
| 容器内存限制与 OOMKilled | Kubernetes |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| class 文件 | 字节码、常量池与方法表的二进制容器 | 不是源文件,也不含注释 |
| 魔数 | 文件头的 0xCAFEBABE | 不是版本号的一部分 |
| 常量池 | 符号引用与字面量的表 | 不是运行期字符串池 |
| 方法描述符 | (Ljava/lang/String;)V 这样的类型签名 | 不是方法体 |
| 双亲委派 | 请求先交给父加载器,它办不到才轮到自己 | 不是硬性规范,框架常打破 |
| JPMS | Java 9 起的模块系统 | 不是 OSGi bundle |
| 反射 | 运行期查询并调用成员 | 不是动态代理本身 |
| 动态代理 | 运行期生成实现指定接口的类 | 不是 CGLIB 子类代理 |
MethodHandle | 可直接调用的方法句柄 | 不是 Method 对象 |
invokedynamic | 把调用点绑定交给 bootstrap 方法 | 不是普通虚调用 |
| 字节码增强 | 改写或生成 class 字节 | 不是源码生成 |
| 卸载 | 类随加载器一起被回收 | 不是单个类被单独卸载 |
2 机制
2.1 心智模型
类加载是一条从字节到可用类型的状态机:加载、链接、初始化,之后才进入使用与卸载。链接内部再分验证、准备、解析,解析可以推迟到第一次使用。双亲委派回答“谁来加载”,初始化回答“静态代码何时执行”。
2.2 机制拆解
- class 文件:魔数、次版本与主版本、常量池、访问标志、字段表、方法表、属性表;方法体放在
Code属性里,主版本号等于 Java 版本加 44,Java 8 是 52,Java 21 是 65。 - 加载:加载器读入字节流,生成
Class对象,把类型元数据写进方法区,HotSpot 里即 Metaspace。 - 验证:文件格式、元数据、字节码与符号引用四层检查,保证不会执行破坏虚拟机的指令。
- 准备:为静态字段分配内存并赋零值;
static final的编译期常量在这一步就写入真值。 - 解析:把常量池里的符号引用换成直接引用,可在首次使用时惰性完成。
- 初始化:执行
<clinit>,父类先于子类,接口不强制触发实现类的初始化。 - 双亲委派:请求先交给父加载器,父加载器无法完成才回到自己;同一加载器对同一名字只加载一次。
- 打破委派:SPI 用线程上下文加载器,Tomcat 给每个 Web 应用一个加载器,OSGi 用网状委派,目的都是同名类共存或实现可替换。
- JPMS:
module-info.class声明导出与依赖,模块路径上的可读性在启动期校验,比 classpath 的“有就能用”更严格。
2.3 完整枚举
生命周期七个阶段:
| 阶段 | 做什么 | 失败会抛 |
|---|---|---|
| 加载 | 读字节流、生成 Class、写入元空间 | ClassNotFoundException、NoClassDefFoundError |
| 验证 | 检查格式、元数据、字节码、符号引用 | VerifyError |
| 准备 | 静态字段分配并赋零值 | OutOfMemoryError: Metaspace |
| 解析 | 符号引用转直接引用 | NoSuchFieldError、NoSuchMethodError |
| 初始化 | 执行 <clinit> | ExceptionInInitializerError |
| 使用 | 实例化、调用、反射 | 各类运行期异常 |
| 卸载 | 加载器不可达时整体回收 | 不抛异常 |
类加载器四个层次:
| 加载器 | 加载范围 | 典型实现 |
|---|---|---|
| Bootstrap | java.base 等核心模块 | JVM 用本地代码实现,getClassLoader() 返回 null |
| Platform | JDK 平台模块,如 java.sql | Java 9 起取代扩展加载器 |
| Application | classpath 与模块路径上的应用代码 | AppClassLoader |
| 自定义 | 指定目录、网络、加密 jar | 继承 ClassLoader 或 URLClassLoader |
触发初始化的六个时机:
| 时机 | 说明 |
|---|---|
| 实例化与静态成员访问 | 对应 new、getstatic、putstatic、invokestatic |
| 反射 | Class.forName 默认初始化,反射访问字段与方法也会触发 |
| 子类先初始化 | 父类先被初始化,接口自身不因此初始化 |
| 启动类 | 含 main 的类在启动时初始化 |
MethodHandle 解析 | 解析到某类的成员时触发该类初始化 |
| 默认方法 | 实现类初始化时,声明默认方法的接口也被初始化 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 魔数 | 4 字节 | 固定为 0xCAFEBABE |
| 主版本 | 52–65 | 对应 Java 8–21,规则是版本加 44 |
| 常量池上限 | 65535 项 | 索引是 16 位无符号数 |
| 方法参数槽 | 254 个 | 实例方法另占一个 this 槽 |
| 单类元数据 | 约 1–10 KB | 与方法数、常量池规模相关 |
| 默认元空间上限 | 不设硬上限 | 受物理内存与 -XX:MaxMetaspaceSize 约束 |
| 首次加载耗时 | 数百微秒 | 受磁盘、jar 解压与验证影响 |
| 卸载条件 | 三件事同时成立 | 类实例、Class 对象、加载器都不可达 |
3 实践
3.1 最小示例
两个文件演示“只加载”与“加载并初始化”的差别,加一个静态块作为可观测信号。
public class Probe {
static {
System.out.println("Probe: clinit");
}
static int value = 7;
}
public class Demo {
public static void main(String[] args) throws Exception {
ClassLoader loader = Demo.class.getClassLoader();
Class.forName("Probe", false, loader);
System.out.println("Probe: loaded only");
Class.forName("Probe", true, loader);
System.out.println("Probe: value=" + Probe.value);
}
}
追踪:运行 Demo 先打印 Probe: loaded only,说明 false 只完成加载与链接,<clinit> 没有执行。第二个 Class.forName 传 true,此时才打印 Probe: clinit。第三行的 Probe.value 不再打印第二次,因为 JVM 对同一加载器上的同一个类只初始化一次。把 loader 换成 null 就是 Bootstrap 视角,Probe 直接抛 ClassNotFoundException,因为应用类不在核心模块里。
loadClass 只做加载,不保证初始化;Class.forName 默认初始化一个类。只想确认依赖是否存在时用前者,需要静态注册生效时用后者。
3.2 常用操作与参数
| 操作 | 命令 / 参数 | 说明 |
|---|---|---|
| 看类从哪加载 | -Xlog:class+load=info | 打印来源与加载器 |
| 看类卸载 | -Xlog:class+unload=info | 确认加载器是否被回收 |
| 加载器统计 | jcmd <pid> VM.classloader_stats | 类数量与存活加载器数 |
| 类直方图 | jcmd <pid> GC.class_histogram | 按类看实例数量 |
| 只加载不初始化 | Class.forName(name, false, loader) | 探测依赖是否存在 |
| 显式初始化 | Class.forName(name) | initialize 默认为 true |
| 资源定位 | loader.getResource("app.properties") | 与类同源查找资源 |
| 模块描述 | java --describe-module com.example | 看导出与依赖 |
| 依赖收敛 | mvn dependency:tree | 定位重复类与版本漂移 |
| 元空间上限 | -XX:MaxMetaspaceSize=256m | 让泄漏尽早暴露 |
3.3 标准流程
- 先确定目标类由哪个加载器负责,用
-Xlog:class+load拿到证据再改代码。 - 依赖版本交给构建工具收敛,不要靠运行时调整 classpath 顺序。
- 判断是否真的需要初始化,在
Class.forName与loadClass之间二选一。 - 插件与脚本用独立加载器,接口放在父加载器可见的位置,实现放在子加载器。
- 反射入口集中一处,缓存
Method与Field,避免在循环里查表。 - 升级 JDK 时同时对齐
--release、构建镜像和运行镜像的版本。 - 需要热部署时先设计卸载:谁持有加载器、谁负责关闭线程与连接。
3.4 与相邻技术的组合
- 构建:
--release决定 class 文件主版本,也决定能用哪些 API。 - 容器:镜像里的 JDK 决定可加载的最高版本,构建与运行镜像版本漂移会变成运行期错误。
- 框架:Spring Boot 的 fat jar 用自定义加载器读
BOOT-INF,所以getResource的语义与普通 jar 不同。 - 增强:Java agent 在加载期改字节,ASM 与 Byte Buddy 用来生成代理和埋点类。
- 模块:JPMS 与 classpath 混用时,未命名模块默认读取全部导出包,模块边界形同虚设。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 加载来源 | classpath / 模块路径 / 自定义路径 | 隔离强度与可读性 |
| 委派方式 | 默认双亲 / 打破 / 网状 | 同名类能否共存 |
| 调用方式 | 直接调用 / 反射 / MethodHandle | 性能与可维护性 |
| 增强时机 | 编译期 / 加载期 / 运行期 | 可调试性与启动成本 |
| 卸载需求 | 不需要 / 需要 | 元空间是否会泄漏 |
3.6 决策规则
- 默认使用双亲委派,它是可预测性的来源,例外必须有明确理由。
- 只有需要同名类多版本共存或可替换实现时,才自定义加载器。
- 反射结果应缓存,热路径宜换成
MethodHandle或直接调用。 - 升级 JDK 前先用
javap -verbose看主版本,再决定改构建还是改镜像。 - 承载插件的加载器应可被丢弃:不留下线程、
ThreadLocal与静态缓存引用。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 直接依赖加双亲委派 | 简单、可预测 | 无法多版本共存 | 绝大多数应用 |
自定义 URLClassLoader | 隔离、可卸载 | 泄漏风险高 | 插件、脚本 |
| OSGi | 动态模块与版本化导出 | 学习与运维成本 | 大型插件平台 |
| JPMS 模块层 | 启动期校验可读性 | 迁移成本 | 新项目、JDK 工具 |
| 进程隔离 | 彻底隔离,崩溃不传染 | 通信与部署成本 | 不可信代码 |
3.8 何时不该用
- 不要为了“隔离”随手创建加载器,每个加载器都会带来一份元空间与卸载负担。
- 不要在业务代码里用反射改私有字段,跨版本升级会直接崩。
- 不要让静态块承担初始化顺序,失败的静态块会把类永久标记为错误。
- 不要在还没有卸载设计时上线热部署,改一次泄漏一次。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
ClassNotFoundException | 名字写错、加载器不对、classpath 缺项 | 打印加载器与资源 URL,确认可见性 |
NoClassDefFoundError | 首次链接或初始化失败,之后每次使用都报 | 找最早的 ExceptionInInitializerError |
LinkageError / IncompatibleClassChangeError | 同名类多版本、接口被改成抽象类 | 统一依赖版本,查重复类 |
UnsupportedClassVersionError | 运行期 JDK 低于编译目标 | 用 --release 对齐,或升级镜像 |
Metaspace OutOfMemoryError | 动态生成类、加载器泄漏 | 限 -XX:MaxMetaspaceSize,查加载器数量 |
ExceptionInInitializerError | <clinit> 抛异常 | 修静态块;该类本次运行不再可用 |
NoSuchMethodError | 依赖版本漂移,编译期与运行期不一致 | 依赖树收敛,锁定版本 |
| 热部署后内存持续上涨 | 旧加载器被线程或 ThreadLocal 持有 | 抓 heap dump 查加载器引用链 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 每个请求新建加载器 | 元空间暴涨 | 复用加载器,按需卸载 |
| 静态字段缓存插件实例 | 加载器无法回收 | 弱引用或显式清理 |
| 依赖 classpath 顺序 | 环境间行为漂移 | 构建期收敛版本 |
| 在静态块里读外部配置 | 初始化失败类不可用 | 移到显式初始化方法 |
| 用反射遍历私有成员 | 升级即碎 | 公开接口或 MethodHandle |
4.3 可观测信号
-Xlog:class+load 与 -Xlog:class+unload 的条数与来源,jcmd VM.classloader_stats 的加载器数量,Metaspace 已用容量与提交量的差,GC.class_histogram 里动态生成类的实例数,以及堆转储中指向加载器的引用链。
4.4 安全 / 性能 / 一致性边界
- 隔离边界:双亲委派保证核心类不会被应用的同名类替换,自定义加载器打破它就等于放弃这层保护。
- 卸载边界:只要还有一条强引用指向加载器,它加载的所有类都留在元空间,单个类无法单独卸载。
- 性能边界:加载本身不贵,贵在验证、磁盘读取与首次反射查表。
- 一致性边界:同一个类被两个加载器加载后是两个类型,互相赋值会抛
ClassCastException。