萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux Tomcat 異常診斷與解決:PermGen/Metaspace OOM、Redeploy 記憶體洩漏全攻略

前言:Tomcat 異常的兩大核心類型

Tomcat 在 Linux 環境下常見的嚴重異常主要集中在記憶體區域:

  1. 永久代/元空間溢位:java.lang.OutOfMemoryError: PermGen space (Java 7 及之前) 或 Metaspace (Java 8+)。
  2. 堆積溢位與重部署洩漏:java.lang.OutOfMemoryError: Java heap space,常發生於熱部署/重新部署後。

本文深入剖析原因、監控指標、JVM 參數調優、程式碼層面排查與預防機制。

一、PermGen / Metaspace 溢位深度解析

Java 7 (PermGen) vs Java 8+ (Metaspace)

特性PermGen (Java 7-)Metaspace (Java 8+)
儲存內容Class 元資料、常數池、內部化字串Class 元資料 (原生記憶體)
位置Heap 內 (固定大小)Native Memory (預設無上限)
預設大小-XX:PermSize=21m -XX:MaxPermSize=82m (視版本)-XX:MaxMetaspaceSize=unlimited
GC 掃描Full GC 時掃描獨立 GC,類卸載觸發條件較寬鬆
常見 OOMPermGen spaceMetaspace

根本原因

  • 載入過多 Class:大量 JSP 預編譯、動態代理 (CGLIB/Javassist)、Groovy/JRuby 腳本、OSGi 模組、熱部署頻繁載入新 ClassLoader。
  • 類加載器洩漏:應用重部署時,舊 WebappClassLoader 未被 GC 回收,持有所有類定義 → Metaspace 持續增長。
  • 字串常數池膨脹 (Java 7):大量 String.intern() 或常量池佔用 PermGen。

解決方案:JVM 參數調優

# 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

二、熱部署 (Redeploy) 導致的 Heap OOM 與類洩漏

現象

執行 manager 應用重新部署、或直接替換 WAR 檔觸發自動重部署後,java.lang.OutOfMemoryError: Java heap space 或後續請求報 NoClassDefFoundError、ClassCastException (舊類實例殘留)。

常見洩漏源頭

洩漏來源機制檢測/解決
JDBC 驅動未註銷DriverManager 靜態註冊表持有驅動實例 → 持有 ClassLoaderServletContextListener.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 清理

診斷工具鏈

  1. Heap Dump 分析:
    # 觸發 Dump
    jmap -dump:live,format=b,file=heap.hprof 
    # 或 OOM 時自動
    -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/dumps
    用 Eclipse MAT / VisualVM / JProfiler 分析:
    • Histogram → 依 classloader 分組 → 找出佔用最大的類加載器。
    • Path to GC Roots → 找出誰持有該 ClassLoader (通常是靜態欄位、ThreadLocal、DriverManager)。
  2. JFR (Java Flight Recorder):-XX:StartFlightRecording 記錄類載入/卸載事件。
  3. Tomcat 內建洩漏偵測:context.xml 加入 <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" /> (預設已啟用),啟動時會預先載入常見洩漏類 (JDBC 驅動、JCE 提供者等) 到系統類加載器,減少應用類加載器洩漏風險。

三、綜合調優建議清單

JVM 參數模板 (Java 17+ / 21 LTS 生產建議)

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
"

Tomcat 配置優化

  • 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 確保流關閉。
  • 依賴注入框架 (Spring) 正確管理 Bean 生命週期 (@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 門檻,才是根治之道。

copyright © 萬盛學電腦網 all rights reserved