Tomcat 在 Linux 環境下常見的嚴重異常主要集中在記憶體區域:
java.lang.OutOfMemoryError: PermGen space (Java 7 及之前) 或 Metaspace (Java 8+)。java.lang.OutOfMemoryError: Java heap space,常發生於熱部署/重新部署後。本文深入剖析原因、監控指標、JVM 參數調優、程式碼層面排查與預防機制。
| 特性 | PermGen (Java 7-) | Metaspace (Java 8+) |
|---|---|---|
| 儲存內容 | Class 元資料、常數池、內部化字串 | Class 元資料 (原生記憶體) |
| 位置 | Heap 內 (固定大小) | Native Memory (預設無上限) |
| 預設大小 | -XX:PermSize=21m -XX:MaxPermSize=82m (視版本) | -XX:MaxMetaspaceSize=unlimited |
| GC 掃描 | Full GC 時掃描 | 獨立 GC,類卸載觸發條件較寬鬆 |
| 常見 OOM | PermGen space | Metaspace |
WebappClassLoader 未被 GC 回收,持有所有類定義 → Metaspace 持續增長。String.intern() 或常量池佔用 PermGen。# Java 7 (PermGen)
JAVA_OPTS="-Xms2g -Xmx2g -XX:PermSize=256m -XX:MaxPermSize=512m \
-XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -XX:+CMSPermGenSweepingEnabled"
# Java 8+ (Metaspace) - 建議設定上限防止吞噬系統記憶體
JAVA_OPTS="-Xms4g -Xmx4g -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m \
-XX:+UseG1GC -XX:MaxGCPauseMillis=200"
關鍵參數:-XX:+CMSClassUnloadingEnabled(Java 7 CMS 必開) 允許 PermGen 類卸載;MaxMetaspaceSize防止 Native Memory 耗盡導致 OS OOM Killer 殺進程。
# 即時監控 Metaspace
jstat -gcmetacapacity 1000
# 或
jcmd VM.metaspace
# 歷史趨勢
jstat -gc 5000 > gc.log
執行 manager 應用重新部署、或直接替換 WAR 檔觸發自動重部署後,java.lang.OutOfMemoryError: Java heap space 或後續請求報 NoClassDefFoundError、ClassCastException (舊類實例殘留)。
| 洩漏來源 | 機制 | 檢測/解決 |
|---|---|---|
| JDBC 驅動未註銷 | DriverManager 靜態註冊表持有驅動實例 → 持有 ClassLoader | ServletContextListener.contextDestroyed 中 DriverManager.deregisterDriver() |
| ThreadLocal 洩漏 | 執行緒池線程復用,ThreadLocal 持有舊類實例 | 關閉時 threadLocal.remove(),或用 ThreadLocalCleaner 庫 |
| 靜態集合/快取持有 | 單例、Guava Cache、EhCache 未清理 | 實作 ServletContextListener 關閉鉤子清理 |
| 日誌框架 (Log4j 1.x / JUL) | LoggerRepository 持有 Logger → ClassLoader | 升級 Log4j 2 / Logback,或 LogManager.shutdown() |
| Proxool / C3P0 / DBCP 舊版 | 內部含舊版 cglib、最終化器引用 | 升級連線池 (HikariCP)、排除舊依賴 |
| 自定義類加載器緩存 | 模板引擎、規則引擎緩存編譯類 | 實作 LifecycleListener 清理 |
# 觸發 Dump
jmap -dump:live,format=b,file=heap.hprof
# 或 OOM 時自動
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/dumps
用 Eclipse MAT / VisualVM / JProfiler 分析:
classloader 分組 → 找出佔用最大的類加載器。-XX:StartFlightRecording 記錄類載入/卸載事件。context.xml 加入 <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" /> (預設已啟用),啟動時會預先載入常見洩漏類 (JDBC 驅動、JCE 提供者等) 到系統類加載器,減少應用類加載器洩漏風險。JAVA_OPTS="
-Xms4g -Xmx4g
-XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=1g
-XX:+UseG1GC
-XX:MaxGCPauseMillis=100
-XX:+ParallelRefProcEnabled
-XX:+HeapDumpOnOutOfMemoryError
-XX:HeapDumpPath=/opt/tomcat/logs/heap_dumps/
-XX:ErrorFile=/opt/tomcat/logs/hs_err_pid%p.log
-Djava.security.egd=file:/dev/./urandom
-Dfile.encoding=UTF-8
-Duser.timezone=Asia/Taipei
"
server.xml:<Executor name="tomcatThreadPool" namePrefix="tomcat-" maxThreads="400" minSpareThreads="50" /> 共享執行緒池。context.xml:<Context antiResourceLocking="true" renewThreadsWhenStoppingContext="true"> 幫助線程清理。JreMemoryLeakPreventionListener、ThreadLocalLeakPreventionListener。ServletContextListener 完整清理資源 (JDBC、線程池、快取、日誌、原生庫)。static 欄位持有大型物件或類加載器引用。try-with-resources 確保流關閉。@PreDestroy)。#!/bin/bash
# emergency_tomcat_oom.sh
PID=$(pgrep -f 'org.apache.catalina.startup.Bootstrap')
if [ -z "$PID" ]; then echo "Tomcat not running"; exit 1; fi
echo "=== JVM 記憶體狀態 ==="
jcmd $PID VM.native_memory summary
jstat -gc $PID
jstat -gcmetacapacity $PID
echo "=== 觸發 Heap Dump ==="
jmap -dump:live,format=b,file=/tmp/heap_$(date +%s).hprof $PID
echo "=== 嘗試優雅重啟 ==="
/opt/tomcat/bin/shutdown.sh
sleep 10
if pgrep -f 'org.apache.catalina.startup.Bootstrap'; then
kill -9 $(pgrep -f 'org.apache.catalina.startup.Bootstrap')
fi
/opt/tomcat/bin/startup.sh
Tomcat 記憶體異常雖然錯誤訊息相似 (OOM),但根因迥異:PermGen/Metaspace 是類元資料洩漏,Heap OOM 則多為重部署資源未釋放。系統性解決需結合 JVM 參數防護、應用層資源清理規範、自動化監控與 Dump 分析流程。將「每次重部署必驗證無洩漏」納入 CI/CD 門檻,才是根治之道。