Java Classpath 疑難雜症終極工具：JWhich — 精確定位類別載入來源

痛點：Classpath 地獄

• 應用依賴數百 JAR，Classpath 動輒上百項
• 同名類別存在多個版本 (傳遞性依賴衝突)
• 類別載入器委派機制 + 首次找到即載入 → 實際載入哪個版本不透明
• 執行時 NoSuchMethodError、LinkageError、行為詭異

類別載入器委派模型

Bootstrap Class Loader (JAVA_HOME/jre/lib/rt.jar)
    ↑ 委派
Extension Class Loader (JAVA_HOME/jre/lib/ext/*.jar)
    ↑ 委派
System / Application Class Loader (CLASSPATH / -cp)
    ↑ 委派
Custom Class Loaders (Web 容器、OSGi、熱部署等)

載入順序：父優先委派 → 自己找。System Class Loader 依 Classpath 項目順序 線性掃描，第一個匹配即載入，後續忽略。

Unix which 啟發

which java 顯示 PATH 中第一個 java 可執行檔路徑。Java 需要同樣工具：給定類別名，輸出實際載入的 .class 檔絕對路徑 (含 JAR 內路徑)。

JWhich 工具設計與使用

使用範例

> java JWhich com.clarkware.ejb.ShoppingCartBean
Class 'com.clarkware.ejb.ShoppingCartBean' found in
'/home/mclark/classes/com/clarkware/ejb/ShoppingCartBean.class'

> java JWhich javax.servlet.http.HttpServlet
Class 'javax.servlet.http.HttpServlet' found in
'file:/home/mclark/lib/servlet.jar!/javax/servlet/http/HttpServlet.class'

核心實作原理

public class JWhich {
    public static void main(String[] args) throws Exception {
        String className = args[0];
        // 關鍵：直接詢問系統類別載入器
        ClassLoader cl = ClassLoader.getSystemClassLoader();
        // 或 Thread.currentThread().getContextClassLoader()
        
        String resourcePath = className.replace('.', '/') + ".class";
        URL url = cl.getResource(resourcePath);
        
        if (url == null) {
            System.out.println("Class not found in classpath");
        } else {
            System.out.println("Class '" + className + "' found in");
            System.out.println("'" + url + "'");
        }
    }
}

關鍵 API： ClassLoader.getResource(String name) — 依載入器搜尋順序返回第一個匹配資源的 URL。

進階功能擴展

• 列出所有匹配：cl.getResources(resourcePath) 返回 Enumeration<URL>，顯示所有版本位置
• 指定載入器：支援 -classloader 參數檢視特定載入器 (WebAppClassLoader 等)
• 版本比對：讀取 META-INF/MANIFEST.MF 顯示 Implementation-Version
• 衝突報告：自動偵測同類別多版本並高亮

實戰排查流程

1. 發現異常 (如 NoSuchMethodError)
2. 執行 java JWhich 可疑類別
3. 確認路徑是否為預期版本 (專案 target/classes? 還是舊版 JAR?)
4. 若非預期 → 檢查 mvn dependency:tree / gradle dependencies 找出傳遞依賴來源
5. 排除依賴 (<exclusion>) 或調整 Classpath 順序
6. 重新驗證

現代替代方案

總結

JWhich 體現「直接問類別載入器」的朴素智慧。理解 ClassLoader.getResource() 即掌握核心。現代專案建議：建構期用 Enforcer 預防、運行期用 Arthas 診斷、CI/CD 門禁檢查重複類別。Classpath 地獄可防、可治、可控。

1. 上一篇文章： FreeBSD 搭建 J2EE 開發環境實戰：Eclipse 3.1 + JDK 1.4.2 + JBoss 3.2.5
2. 下一篇文章： J2EE SDK 1.4 + Resin 2.1.16 安裝部署完整步驟

Java 程式設計入門

企業級 Java 框架基石：通用基類體系設計與實現 (Controller/Service/Mapper/POJO)

設計目標 消除 CRUD 重複代碼，統一分頁、返回格式、異常

MIDP 聯網應用程式開發教學：HTTP 通訊完整指南

引言 上一講介紹了如何利用 Record Store 在終端

iBatis DAO 框架入門：從 SQL Maps 遷移到 DAO 模式的完整實戰

為什麼需要 DAO 模式？ 核心 J2EE 模式建議：將所有

Struts 框架核心架構解析：MVC 模式在 J2EE 中的經典落地

Struts 定位：J2EE 時代的 MVC 先驅 Stru