Classpath 迷霧重重？一次搞懂 Java 類別載入機制

周末嘗試重啟舊專案 (JSP + JavaBean + Servlet + SQL Server)，環境配置看似無誤 (Tomcat、JDBC 驅動、JSP/Servlet/JavaBean 測試均通)，卻在瀏覽器存取時噴出 This connection has not been established yet.。經排查發現：命令列執行能載入 JDBC 驅動，Eclipse/ Tomcat 卻找不到類別。本文記錄完整排查過程與核心真相。

問題現場還原

• 系統透過 JavaBean 存取資料庫
• SQL Server JDBC 三個 JAR (msbase.jar, mssqlserver.jar, msutil.jar) 已加入系統 CLASSPATH 環境變數
• 命令列 java BeanClass 執行正常，資料庫連線成功
• Eclipse 專案執行同一 Bean 報 ClassNotFoundException: com.microsoft.jdbc.SQLServerDriver
• Tomcat 啟動後 JSP 存取同樣報錯

排查關鍵節點

1. Eclipse 專案加入 JAR 後正常：證實程式碼無誤，問題在類別載入路徑差異
2. 批次檔設定 classpath 再啟動 Tomcat 無效：set classpath=... → startup.bat，錯誤依舊
3. 將 JAR 放入 JDK/jre/lib/ext 成功！：系統神奇般恢復正常

同事點撥核心真相

命令列模式：JVM 自動載入系統環境變數 CLASSPATH 指定的路徑。
IDE/應用伺服器模式：忽略系統 CLASSPATH，使用自身定義的類別路徑 (Eclipse: 專案 Build Path；Tomcat: WEB-INF/lib、common/lib、shared/lib 等)。

用 System.getProperties() 驗證差異

批次檔修改 CLASSPATH 僅影響 java.class.path，Tomcat 啟動時已讀取自身配置，**不會重讀環境變數**。

三種標準解決方案 (優先序)

1. Web 應用標準做法：JAR 放入 WEB-INF/lib/ → **隨專案部署、移植性最佳** ✅
2. 伺服器共享庫：JAR 放入 Tomcat common/lib/ 或 shared/lib/ → 多應用共享
3. JRE 擴展目錄：JAR 放入 jre/lib/ext/ → **全域生效、但污染 JRE、不利版本隔離** ⚠️

後記心得

• 命令列 java -cp 或 CLASSPATH 僅對獨立 Java 應用有效
• Web 容器有獨立類別載入器體系 (Bootstrap → System → Common → Webapp)，**Webapp 類別載入器優先載入 WEB-INF/classes、WEB-INF/lib/*.jar**
• 團隊開發請統一採用 WEB-INF/lib 方式，並納入版控或使用 Maven/Gradle 管理依賴