metaspace-oom

Metaspace OOM

现象

应用运行一段时间后抛出 java.lang.OutOfMemoryError: Metaspace，重启后恢复；堆内存看起来不高，但类加载数量持续增长。

快速定位

jcmd <PID> VM.metaspace
jcmd <PID> GC.class_stats | sort -k3 -n | tail
jstat -gcmetacapacity <PID> 1000 10

查看容器内存和 JVM 参数：

jcmd <PID> VM.flags | grep -E 'Metaspace|MaxRAM'
cat /sys/fs/cgroup/memory.max

常见根因

• 动态生成类过多（反射、CGLIB、Groovy、脚本引擎）且没有卸载。
• 热部署/类加载器泄漏，旧 ClassLoader 无法回收。
• MaxMetaspaceSize 设置过小。
• 容器内存限制过低，元空间和堆争抢内存。
• 大量代理类、lambda 或 ASM 生成类没有缓存上限。

修复

• 设置合理的 -XX:MaxMetaspaceSize，并预留容器内存。
• 修复 ClassLoader 泄漏，避免重复创建类加载器。
• 限制动态类生成和脚本编译缓存。
• 升级依赖，修复已知的类加载泄漏问题。
• 用 jcmd VM.metaspace 观察 committed/used 趋势。
• 滚动重启只能临时缓解，必须找到泄漏源。

相关命令

• jcmd — Metaspace 和类统计
• jstat — 元空间容量
• jmap — 堆和类直方图
• jvm-gc-overhead — 关联的 GC 问题