Java / 系统课时
排查 Metaspace 与类加载器泄漏
排查 Metaspace 与类加载器泄漏
Metaspace OOM 不能只靠增大上限处理。真正要回答的是:类和 ClassLoader 数量是否持续增长、哪些加载器无法卸载、谁通过引用链把它们留在 GC Roots 上。以下以 HotSpot JDK 21 为例,建立从现场证据到修复验证的排查顺序。
学习目标
- 用
jcmd判断 Metaspace、类数量和 ClassLoader 是否持续增长。 - 解释类卸载与 ClassLoader 可达性的关系,识别热部署、线程和动态代理造成的保留链。
- 根据增长模式区分容量不足、类生成过量与 ClassLoader 泄漏,并验证修复是否形成稳定平台。
先确认是不是 Metaspace 问题
典型异常是 java.lang.OutOfMemoryError: Metaspace。此时 Java 堆可能并不高,因为类元数据主要存放在本地内存的 Metaspace。先保留异常时间、部署次数和进程 RSS,再查看当前 Metaspace、类数量与 ClassLoader 统计,避免一上来重启而丢失现场。
jcmd <PID> VM.metaspace basic scale=MB
jcmd <PID> VM.classloader_stats预期输出的关键字段类似下面这样,具体数值、加载器类型和行数会因应用而异:
Total Usage - <VALUE> loaders, <VALUE> classes
Non-Class: ... <VALUE> MB ... used
Class: ... <VALUE> MB ... used
ClassLoader ... Classes ... ChunkSz ... BlockSz ... Type
...
Total = <VALUE> ...不要只看一次快照。应在相同负载下间隔采样,尤其是在每次热部署、插件刷新或脚本重载之后记录 loaders、classes 与 used。若业务负载相近而三者持续单调增长,就比“某一时刻 Metaspace 很大”更像泄漏证据。
理解为什么一个 ClassLoader 会拖住一批类
类卸载不是“某个类暂时没人用就立刻释放”。对于普通应用类,更重要的边界是定义它们的 ClassLoader 是否仍然可达;当旧 ClassLoader 被长生命周期对象保留时,它定义的那批类通常也无法随部署周期一起卸载。

热部署最常见的保留点包括:由旧应用加载器创建但没有停止的线程或线程池、长生命周期线程中的 ThreadLocal、线程的 context class loader、父加载器或全局单例中的静态缓存、监听器、驱动或 MBean 注册项。只要引用链从更长生命周期的对象通向旧加载器,旧版本的类就会一起留下。
另一类问题不是“加载器越来越多”,而是同一个长期存活的加载器不断定义新类。例如代理、字节码增强或动态脚本以不断变化的类名生成类型。此时 loader 数量可能稳定,但 classes 与 Metaspace 仍持续增长,修复方向应转向限制类生成和复用生成结果。
按增长模式缩小根因
先检查 JVM 是否人为限制了 Metaspace,以及类卸载相关行为是否符合预期。MaxMetaspaceSize 过小可能让正常应用过早 OOM;反过来,如果存在泄漏,单纯放大它只会延后失败。
jcmd <PID> VM.flags -all | grep -E 'MaxMetaspaceSize|ClassUnloading'预期输出会包含对应的 JVM flag;数值和格式随 JDK 版本、平台与启动参数不同:
size_t MaxMetaspaceSize = <VALUE> ...
bool ClassUnloading = <VALUE> ...接着按增长模式缩小范围。若 VM.classloader_stats 中同一种业务 ClassLoader 实例随部署轮次增加,优先查旧加载器的 GC Roots 保留链;维护窗口内可获取 heap dump,再用 MAT 等工具从可疑 ClassLoader 查看 Path to GC Roots。若加载器数量稳定而类数不断增加,则进一步查看该加载器下是否存在大量名称带随机后缀的代理类、增强类或脚本类。
修复后用部署周期验证
热部署泄漏的修复原则是让旧应用生命周期真正结束:停止由旧版本创建的线程和调度器,清理 ThreadLocal,注销监听器、驱动和管理对象,避免父加载器中的全局缓存持有子加载器对象。动态代理或字节码生成场景则应使用稳定 key 的缓存、复用生成类,避免按请求或按租户无限创建新类型。
验证时至少跨越多个部署或刷新周期重复采样。健康结果不是要求 Metaspace 回到初始值,而是旧加载器能够卸载,loader/class 数量在合理范围内波动并形成平台,Metaspace used 不再随每一轮操作持续抬升。若需要观察卸载事件,可在下一次受控启动时启用 -Xlog:class+unload=info,gc+metaspace=debug,再把日志时间点与部署动作对应起来。最终应关注趋势是否停止持续上扬,而不是追求某个固定的 Metaspace 数值。