Tomcat 5 啟動流程與核心配置深度解析

Tomcat 5 作為經典 Servlet 容器，其啟動機制與目錄結構體現了 Java 類加載器層級隔離的核心設計。本文系統梳理目錄職責、類加載器體系、server.xml 組件模型及核心接口，助你透徹理解容器運作原理。

一、 目錄結構與職責劃分

Tomcat 根目錄（$CATALINA_HOME）下 9 大目錄各司其職：

• bin/：啟動/關閉腳本（startup.bat/sh、shutdown.bat/sh）。
• common/：lib/ 存放 Tomcat 與所有 Web 應用共享的 JAR（如 Servlet API、JDBC 驅動）。
• shared/：lib/ 存放僅 Web 應用可見、Tomcat 不可見的 JAR。
• server/：webapps/ 內置管理應用；lib/ 存放 Tomcat 內部實現 JAR，對 Web 應用不可見。
• webapps/：Web 應用部署目錄（WAR 或解壓目錄）。
• work/：JSP 編譯生成的 Servlet 源碼與類文件緩存。
• temp/：運行時臨時文件。
• logs/：日誌輸出目錄。
• conf/：核心配置文件，server.xml 為核心。

設計精髓： 通過目錄隔離實現「可見性」控制，構建雙親委派模型的物理基礎。

二、 類加載器層級體系與啟動流程

啟動入口：startup.bat → org.apache.catalina.startup.Bootstrap。類加載器呈樹狀結構：

Bootstrap (JVM 核心庫 + $JAVA_HOME/jre/lib/ext/*.jar)
  └─ System ($CATALINA_HOME/bin/bootstrap.jar + tools.jar)
       └─ Common ($CATALINA_HOME/common/classes, lib, endorsed)
            ├─ Catalina ($CATALINA_HOME/server/classes, lib)  // 僅 Tomcat 可見
            └─ Shared ($CATALINA_HOME/shared/classes, lib)    // 僅 WebApp 可見
                 └─ WebAppX (WEB-INF/classes, WEB-INF/lib)    // 單一 WebApp 專用

關鍵加載器說明：

• CommonClassLoader：載入 servlet.jar、xerces.jar、JNDI 相關包等公共庫。注意：WebApp 類不應放此處。
• CatalinaClassLoader：載入 catalina.jar、Coyote、JK 連接器等容器核心實現，對 WebApp 完全不可見，保證容器內部實現隔離。
• SharedClassLoader：載入 Jasper 編譯器、JNDI 工廠等 WebApp 共享庫，Tomcat 自身不可見。
• WebAppClassLoader：打破雙親委派——優先從 WEB-INF/classes、WEB-INF/lib 載入，失敗才委派給父加載器。實現 WebApp 間類隔離，不同應用可使用同類庫不同版本。

類/資源搜尋順序（WebAppClassLoader）：

1. /WEB-INF/classes
2. /WEB-INF/lib/*.jar
3. Bootstrap
4. System
5. $CATALINA_HOME/common/classes
6. $CATALINA_HOME/common/endorsed/*.jar
7. $CATALINA_HOME/common/lib/*.jar
8. $CATALINA_HOME/shared/classes
9. $CATALINA_HOME/shared/lib/*.jar

此順序確保 WebApp 自身類優先，避免容器庫污染應用。

三、 server.xml 組件模型詳解

server.xml 定義容器組件拓撲，四大元素類別：

核心層級關係：

<Server> (監聽 shutdown 命令)
  └─ <Service> (名稱唯一)
       ├─ <Connector> (一個或多個，如 HTTP/8080、AJP/8009)
       └─ <Engine> (唯一，默認 defaultHost)
            ├─ <Host> (虛擬主機，name=localhost, appBase=webapps)
            │    └─ <Context> (Web 應用，path=/myapp, docBase=...)
            └─ <Context> (也可直接掛在 Engine 下)

重要配置要點：

• <Context> reloadable="true"：開發環境建議開啟，熱加載 WEB-INF/classes、lib 變更。
• <Host> unpackWARs="true"：自動解壓 WAR 包。
• 官方建議：Tomcat 5.x 不推薦 在 server.xml 直接寫 <Context>，應放在 META-INF/context.xml 或 conf/[enginename]/[hostname]/ 下，便於熱部署與管理。

四、 核心組件接口架構

Tomcat 組件遵循標準接口，支撐熱插拔與生命週期管理：

• Lifecycle：統一 start()/stop()，所有主要組件實現。
• Container：請求處理核心接口，四層結構 Engine → Host → Context → Wrapper。Wrapper 代表單個 Servlet，管理其生命週期。
• Pipeline / Valve：責任鏈模式處理請求。Valve 可檢查/修改 Request/Response、包裝對象、決定是否調用 invokeNext()。AccessLogValve 記錄訪問日誌。
• Loader：封裝 ClassLoader，實現類加載隔離。
• Realm：安全認證授權（JDBC、JNDI、Memory、JAAS）。
• Resources：JNDI 資源訪問抽象。
• Manager：Session 池管理（標準/持久化/集群）。

五、 Web 應用標準目錄結構

HELLOAPP/              ← Web 應用根目錄 (JSP, HTML, CSS, JS)
├─ WEB-INF/            ← 受保護目錄，客戶端不可直接訪問
│   ├─ web.xml         ← 部署描述符 (Servlet、Filter、Listener 配置)
│   ├─ classes/        ← 編譯後的類文件 (包結構)
│   └─ lib/            ← 應用專用 JAR 包

此結構為 Servlet 規範強制要求，也是 WebAppClassLoader 掃描的基礎路徑。

總結

Tomcat 5 通過「目錄隔離 + 類加載器樹 + 組件化接口」實現了：

1. 容器與應用隔離：Catalina 類庫不洩露給 WebApp。
2. 應用間隔離：WebAppClassLoader 打破雙親委派，優先自載。
3. 共享可控：Common/Shared 目錄提供不同可見層級的共享庫。
4. 熱部署支撐：Context reloadable、work 目錄 JSP 重編譯。

理解這些機制，是排查 ClassNotFoundException、LinkageError、熱部署失效、安全配置等疑難雜癥的鑰匙。