metaspace 泄露本质是类加载器未被回收导致元数据堆积；需通过 jvm 参数监控、jcmd/mat 定位异常类加载器，并修复 threadlocal、静态缓存、监听器注册等常见泄露点。
理解 Metaspace 与类加载器泄露的关系
Java 8+ 中，永久代被 Metaspace 取代，它使用本地内存存储类元数据（如类名、字段、方法字节码、常量池等）。当应用频繁动态生成类（如 Spring AOP、Groovy 脚本、OSGi、热部署框架），又未正确卸载旧类时，对应的 类加载器实例无法被 GC 回收，其加载的所有类元数据就持续占用 Metaspace —— 这就是典型的类加载器泄露。它不会立刻抛出 OutOfMemoryError: Metaspace，但会随时间推移缓慢增长，最终触发错误。
捕获并确认是 Metaspace 而非堆内存问题
启动 JVM 时添加关键参数，让 OOM 发生时保留线索：
-
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path/to/dumps：对堆有用，但 Metaspace 泄露时堆可能很空，此参数不直接帮助； -
必须加：
-XX:+PrintGCDetails -XX:+PrintGCTimeStamps -XX:+PrintMetaspaceInfo（JDK 10+ 推荐用-Xlog:gc*,metaspace=debug）； -
-XX:MaxMetaspaceSize=256m（设合理上限，加速复现，避免耗尽系统内存）； -
-XX:+UnlockDiagnosticVMOptions -XX:+PrintConcurrentLocks -XX:+PrintClassHistogram（OOM 前可辅助诊断）。
当出现 java.lang.OutOfMemoryError: Metaspace 时，日志中会明确标出，且 Metaspace 区 usage 持续逼近 MaxMetaspaceSize，而 CompressedClassSpace 和堆使用率正常——这基本锁定为类元数据堆积问题。
定位泄露的类加载器：从 jcmd 到 MAT 分析
发生 OOM 后，立即用 jcmd <pid> VM.native_memory summary scale=MB</pid> 查看 Metaspace 实际占用；再执行：
-
jcmd <pid> VM.class_hierarchy -all</pid>：列出所有已加载类及其类加载器 ID（如java.net.URLClassLoader@6e3c1e69）； -
jcmd <pid> VM.classloader_stats</pid>：输出每个类加载器加载的类数量，重点关注数量异常高、长期存在且不断增长的自定义类加载器（如WebAppClassLoader、RestartClassLoader）； - 若进程仍在运行，用
jmap -clstats <pid></pid>（JDK 8）或jcmd <pid> VM.classloader_stats</pid>（JDK 9+）获取更详细统计。
导出堆转储（jmap -dump:format=b,file=heap.hprof <pid></pid>），用 Eclipse MAT 打开后：
- 执行 “Leak Suspects” 报告，MAT 常能自动识别持有着大量
java.lang.Class实例的类加载器； - 打开 “Dominator Tree”，按
Retained Heap排序，筛选ClassLoader子类，查看谁持有最多Class实例； - 右键可疑类加载器 → “Merge Shortest Paths to GC Roots”（排除弱/软引用），观察哪些静态字段、线程局部变量（ThreadLocal）、缓存容器（如
ConcurrentHashMap）强引用了它。
常见泄露场景与修复方向
多数类加载器泄露源于“注册未注销”或“缓存未清理”：
-
ThreadLocal 持有 ClassLoader：某些框架（如 Log4j2、JDBC 驱动）在 ThreadLocal 中存了与当前 classloader 绑定的上下文，线程复用（如 Tomcat 线程池）导致 classloader 无法卸载 → 使用
ThreadLocal.remove()清理，或改用WeakReference； -
静态集合缓存 Class 或 ClassLoader：例如工具类中
private static final Map<string class> CACHE = new ConcurrentHashMap();</string>，key 是类名，value 是通过当前 classloader 加载的 Class → 改为使用WeakHashMap<classloader map class>></classloader>分层缓存； -
未关闭的资源监听器：如 JMX MBean、JNDI Context、Spring 的
ApplicationListener注册后未反注册 → 在应用关闭钩子（ServletContextListener.contextDestroyed）中显式注销； -
字节码增强框架残留：CGLIB、ByteBuddy 动态生成的类未设置
useCache(false)或未清理Enhancer实例 → 检查代理创建逻辑，限制生成类数量，或启用-Dnet.sf.cglib.core.DebuggingClassWriter=true输出生成类路径辅助追踪。
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
