JWhich 工具：精準定位 CLASSPATH 中類別的實際載入路徑

CLASSPATH 優先級陷阱

類別載入器按順序掃描 CLASSPATH，第一個同名類別即被載入，後續同名類別被「隱藏」。專案增長導致 CLASSPATH 膨脹、版本衝突、重複項目時，極難判斷實際載入的是哪個 JAR/目錄。

JWhich 設計靈感

Unix which 指令：分析 PATH 顯示可執行檔實際路徑。JWhich 移植此概念至 Java 類別載入機制。

使用範例

> 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'

核心原始碼 (約 40 行)

public class JWhich {
    public static void which(String className) {
        if (!className.startsWith("/")) className = "/" + className;
        className = className.replace('.', '/') + ".class";

        // 向「載入 JWhich 自身的 ClassLoader」查詢資源
        URL classUrl = new JWhich().getClass().getResource(className);

        if (classUrl != null) {
            System.out.println("Class '" + className + "' found in '" + classUrl.getFile() + "'");
        } else {
            System.out.println("Class '" + className + "' not found in '" +
                System.getProperty("java.class.path") + "'");
        }
    }

    public static void main(String[] args) {
        if (args.length > 0) which(args[0]);
        else System.err.println("Usage: java JWhich ");
    }
}

關鍵技術細節

1. Class.getResource() 委派給載入該類別的 ClassLoader，自動遵循雙親委派模型，完整模擬實際載入邏輯。
2. 在 Servlet 容器/EJB 伺服器中執行時，會使用該容器的自訂 ClassLoader，自動適應環境。
3. 資源名稱轉換：. → /、前綴 / 表示絕對路徑匹配、附加 .class。

進階應用

• 建構 Classpath 審計報表：批次掃描專案所有類別，偵測重複/衝突
• 整合至建置腳本 (Ant/Maven/Gradle) 驗證發布套件
• 除錯 NoClassDefFoundError、LinkageError、版本不一致

現代替代方案

• java -verbose:class：JVM 參數，啟動時印出所有載入類別來源
• Arthas / Greys / BTrace：線上診斷工具，支援 sc、classloader 指令
• IDE 內建：IntelliJ "Analyze Classpath Conflicts"、Eclipse "Open Type" 顯示來源 JAR

JWhich 雖簡單，卻直擊 CLASSPATH 核心痛點，是理解類別載入機制的最佳教學工具之一。