JWhich：解決 CLASSPATH 衝突的利器——找出到底載入了哪個類別

CLASSPATH 的隱性陷阱

Java 類載入器按 CLASSPATH 順序搜尋，**第一個同名類別即被載入，後續同名類別被「隱藏」**。當專案依賴增長、多模組合併、第三方 JAR 內含相同包名類別時，常出現：

• 編譯通過，執行期 NoSuchMethodError/ClassCastException
• 預期行為與實際不符，除錯極其困難
• 「明明有這方法，為什麼說找不到？」

Unix which 啟發：JWhich 誕生

Unix which cmd 顯示命令實際執行路徑。同理，JWhich 接收類別全名，輸出**類載入器實際載入的 .class 檔絕對路徑**（含 JAR 內部路徑）。

使用範例

> java JWhich com.myapp.service.UserService
Class 'com/myapp/service/UserService.class' found in
'file:/home/user/projects/myapp/target/classes/com/myapp/service/UserService.class'

> java JWhich javax.servlet.http.HttpServlet
Class 'javax/servlet/http/HttpServlet.class' found in
'file:/home/user/.m2/repository/javax/servlet/servlet-api/2.5/servlet-api-2.5.jar!/javax/servlet/http/HttpServlet.class'

核心原理：直接問類載入器

public class JWhich {
    public static void which(String className) {
        // 1. 格式化為資源路徑：/com/myapp/service/UserService.class
        if (!className.startsWith("/")) className = "/" + className;
        className = className.replace('.', '/') + ".class";

        // 2. 請求載入 JWhich 自身的類載入器尋找資源
        URL classUrl = JWhich.class.getResource(className);

        // 3. 輸出結果
        if (classUrl != null) {
            System.out.println("Class '" + className + "' found in '" + classUrl.getFile() + "'");
        } else {
            System.out.println("Class '" + className + "' NOT found in classpath: " + 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() 委派給**載入該類的類載入器**搜尋資源，完美模擬實際類載入邏輯
2. 若在 Servlet 容器/EJB 伺服器中運行，JWhich 會使用**該容器的類載入器層級**，自動遞迴委派父載入器
3. 回傳 URL 可區分：file:/path/to/file.class（目錄）vs file:/path/to.jar!/pkg/Class.class（JAR 內部）

進階用法與擴展

• 列出所有同名類別位置：遍歷 ClassLoader.getResources() 獲取全部匹配 URL
• 整合至建構腳本：Maven exec-maven-plugin / Gradle task 自動掃描衝突類別
• IDE 外掛：IntelliJ IDEA "Show Bytecode" / Eclipse "Open Type" 內建類似功能
• 容器化環境：docker exec app java -cp /app/* JWhich com.foo.Bar 診斷生產環境類衝突

現代替代工具

總結

JWhich 體現了「直接問類載入器」的朴素智慧。雖然現代工具鏈提供更強大的診斷能力，但理解類載入器委派模型、CLASSPATH 搜尋順序、資源路徑格式，仍是每位 Java 開發者解決「類衝突」疑難雜症的內功心法。