核心是让模块级类加载器能被GC回收:需主动管理TCCL(设前保存、执行后恢复)、卸载时清空静态缓存/注销监听器/关闭URLClassLoader,并通过JVM参数(如-Xlog:class+unload=info)验证MCU/MCL比值≥5%。
核心是让模块级类加载器能被 gc 回收,而不是等线程销毁——线程只是泄漏的“中转站”,真正卡住元空间的是它背后强引用的类加载器。
先确认是不是线程导致的类加载器滞留
动态模块按需加载通常会为每个模块创建独立类加载器(如 URLClassLoader 或自定义子类),并在线程中使用。但问题不在“线程没销毁”,而在“线程执行时把类加载器设为了 TCCL(Thread Context ClassLoader)且未恢复”。一旦设了又忘了重置,该线程(尤其是池化线程)就会长期持有一个模块加载器的强引用。
验证方法:
- 用
jcmd <pid> VM.classloader_stats</pid>查看加载器实例数是否持续增长,尤其关注名字含Module、Plugin、Dynamic的加载器 - 执行
jstack <pid> | grep -A 5 -B 5 "setContextClassLoader"</pid>,看是否有线程在调用后没配对恢复 - 抓堆转储(
jmap -dump:format=b,file=heap.hprof <pid></pid>),用 MAT 打开 → “Class Loader Explorer”,找 Retained Heap 大、Loaded Classes 多但已无业务使用的加载器,再对其做 “Path to GC Roots”(排除 weak/soft)→ 很可能指向某个线程的contextClassLoader字段
在线程执行边界主动切断 TCCL 引用
不是等线程退出,而是在每次模块任务执行前后显式管理 TCCL:
- 进入模块逻辑前保存原始 loader:
ClassLoader original = Thread.currentThread().getContextClassLoader(); - 设置模块专属 loader:
Thread.currentThread().setContextClassLoader(moduleClassLoader); - 无论成功失败,都必须在 finally 块中恢复:
Thread.currentThread().setContextClassLoader(original);
如果用的是线程池(如 ThreadPoolExecutor),建议包装 Runnable 或使用 ThreadLocal 做自动清理,避免漏写 finally。
模块卸载时同步清理所有关联资源
模块停用 ≠ 类加载器自动消失。必须主动触发释放链:
- 清空模块内部静态缓存(如
ConcurrentMap<string class></string>),否则 Class 对象会反向强引类加载器 - 注销该模块注册的所有监听器、定时任务、MBean、SPI 服务提供者 —— 这些都可能隐式持有 Class 或 ClassLoader
- 显式关闭或
null掉模块持有的URLClassLoader实例,并调用其close()(JDK 7+ 支持)释放底层JarFile等资源 - 若模块使用了 CGLIB/Javassist 动态代理,确保代理缓存(如 Spring 的
AdvisedSupport缓存)也随模块一并清除
加 JVM 参数强制验证卸载行为
仅靠代码清理不够,要让 JVM 把卸载动作真实跑出来:
- 启动参数加上:
-XX:+UnlockDiagnosticVMOptions -XX:+PrintClassHistogramAfterFullGC -Xlog:class+unload=info - 运行一段时间后执行
jstat -gc <pid></pid>,观察MCL(loaded classes)是否稳定、MCU(unloaded classes)是否持续增长 - 理想状态是:模块卸载后,对应类加载器实例数下降,且
MCU / MCL ≥ 5%;若MCU长期为 0,说明卸载条件仍不满足,得回头查引用链
不复杂但容易忽略:元空间挤爆从来不是因为“类太多”,而是“类加载器赖着不走”。盯住 TCCL、静态缓存、监听器这三处,基本就稳了。

















