看到OutOfMemoryError: Metaspace，说明JVM类元数据区耗尽，与堆内存无关；需先确认错误后缀为Metaspace，再通过jstat -gc查看MU/MC是否趋近满载，结合jcmd或JConsole验证占用，并定位反射、动态代理等高频加载且无法卸载的类源头。
看到 java.lang.OutOfMemoryError: Metaspace，说明 JVM 存“类蓝图”的地方满了——不是堆内存不够，也不是直接内存问题，而是类元数据持续堆积、卸不干净导致的。排查核心就三件事：确认它真满了、查谁在疯狂加载、看类为什么卸不掉。
确认 Metaspace 是否真的耗尽
别光信报错，得验证实际使用情况：
- 用
jstat -gc <pid>查看 MU（Metaspace Used） 和 MC（Metaspace Capacity）：如果 MU 长期 > 90% MC，且 MC 在缓慢上涨，说明正在反复扩容；若 MC 已达-XX:MaxMetaspaceSize上限而 MU 仍逼近它，就是真满了 - 用
jcmd <pid> VM.native_memory summary scale=MB看 native memory 中 Class 区域占用，重点关注 “committed” 值是否异常偏高（比如超 300MB 且持续增长） - 打开 JConsole 或 VisualVM，连上进程，直接查看
java.lang:type=MemoryPool,name=Metaspace的Usage.used和Usage.max，比对更直观
定位高频加载或重复加载的类
Metaspace 溢出本质是“类越积越多”，重点找动态生成、热部署、反射密集的源头：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 加启动参数临时追踪：
-XX:+TraceClassLoading -XX:+TraceClassUnloading，运行一段时间后 grep 日志，统计哪些类被反复加载却极少卸载（尤其注意含EnhancerByCGLIB、$Proxy、GeneratedMethodAccessor、sun.reflect.的类名） - 执行
jcmd <pid> GC.class_stats > class_stats.txt，分析文件中 ClassLoader 列，识别某个加载器（如LaunchedURLClassLoader、WebAppClassLoader）是否加载了上万个类 - 用 Arthas 连上进程：
vmtool --action getInstances --className java.lang.ClassLoader --limit 20，看非系统类加载器实例数量和存活时间；再用sc -d *.*搜索可疑类，结合stack查调用栈
检查类卸载失败的关键原因
Metaspace 不是靠普通 GC 清理的，卸载依赖 ClassLoader 被回收——只要加载器还活着，它加载的所有类元数据就卡在那儿：
立即学习“Java免费学习笔记（深入）”；
- 确认是否有自定义 ClassLoader 未正确关闭（比如未实现
close()、未清理静态引用、或被 ThreadLocal 持有） - 检查 Spring Boot DevTools、Tomcat 热部署、OSGi bundle 卸载等场景：旧版本类加载器是否残留？是否存在 WebAppClassLoader 被强引用导致无法 GC？
- 留意反射软引用策略：如果设置了
-XX:SoftRefLRUPolicyMSPerMB=0，ReflectionData容易被频繁回收重建，触发大量重复反射类加载 - 验证 GC 是否尝试卸载：看 GC 日志里是否有
[Full GC (Metadata GC Threshold)]，但之后 MU 并未明显下降，说明卸载失败
参数与修复建议
调参只是辅助，不能替代代码和架构治理：
- 生产必须设上限：
-XX:MaxMetaspaceSize=256m（中小应用）或512m（Spring Cloud 微服务），避免吃光系统内存 - 搭配初始阈值：
-XX:MetaspaceSize=128m，让 GC 更早介入，而不是等到默认几十 MB 就触发 - G1 垃圾收集器下可启用：
-XX:+ClassUnloadingWithConcurrentMark，提升类卸载成功率 - 禁用不必要的动态机制：如 AOP 中避免
proxy-target-class=true对所有类强制 CGLIB 代理；关闭 DevTools 热部署上线环境；限制 Groovy/ScriptEngine 使用频次
