J2EE 類加載機制全解析：從 WebSphere 類加載器層級到最佳實踐

J2EE 應用在 WebSphere 等容器中運行時，類加載錯誤（如 ClassNotFoundException）是開發者常見痛點。本文系統梳理 J2EE 模塊結構、WebSphere 類加載器層級關係、隔離模式，並給出模塊依賴管理、JAR 包放置、鬆散類與 JAR 選型的落地最佳實踐，助你從根源消除類加載疑難雜症。

J2EE 三大模塊與企業應用（EAR）

• Web 模塊 (WAR)：含 HTML、JSP、Servlet、WEB-INF/classes（鬆散類，支持熱重載）與 WEB-INF/lib（JAR 包）。
• EJB 模塊 (JAR)：含 Bean、部署描述符、助手類，業務邏輯核心。
• 應用客戶端模塊：非 Web 類 Java 客戶端，享受容器資源與 JNDI 便利。
• 企業應用 (EAR)：聚合上述模塊，統一部署，可共享 JAR（放置 EAR 級 lib），避免全局類路徑污染。

WebSphere 類加載器層級與委派模型

簡化層級（自上而下）：

1. Java 系統類加載器（CLASSPATH）
2. WebSphere 擴展類加載器（ws.ext.dirs，載入 J2EE/容器類）
3. 模塊類加載器（每個模塊一個，遵循 J2EE 規範）

關鍵規則：請求優先委派父加載器，父找不到再由子加載。請求只能向上，不能向下。若 WebSphere 類加載器需查找模塊類，會拋出 ClassNotFoundException。

四大隔離模式與選型建議

鐵律：不要依賴隔離模式。應用必須在 Module 模式下也能正常運行，通過 MANIFEST.MF Class-Path 顯式聲明依賴。

模塊依賴的正確打開方式：MANIFEST.MF + Application Developer

1. 編譯期：勿手動修改 Java Build Path。
2. 運行期：在 MANIFEST.MF 的 Class-Path 屬性中引用所需 JAR 或模塊。
3. 工具支持：右鍵 J2EE 項目 → Edit Module Dependencies，勾選依賴模塊/JAR，IDE 自動同步 MANIFEST.MF 與 Build Path。

JAR 包放置決策樹

• 單一 Web 模塊使用 → WEB-INF/lib
• 同一 EAR 多模塊共享 → EAR 級 lib + Edit Module Dependencies
• 全局工具類（極少見） → ws.ext.dirs（需訪問 J2EE 類）或 CLASSPATH（否則），但強烈不建議，會導致版本衝突、部署耦合、測試環境失真。

鬆散類 vs JAR：階段性選擇

• 早期/高頻變更：鬆散類（WEB-INF/classes 或 ejbModule），支持熱重載/重啟項目即時生效。
• 穩定/生產部署：打包為 JAR，結構清晰，接近生產環境。
• 跨 EAR 與普通 Java 共用：打包 JAR 放 EAR 或獨立 Java 項目（需手動維護 Build Path 與服務器類路徑）。

編譯期類路徑 ≠ 運行期類路徑

編譯靠 Java Build Path；運行靠容器類加載器鏈與 MANIFEST.MF。編譯通過不代表運行無誤，理解兩者差異是排查 ClassNotFoundException 的關鍵。