Tomcat CLASSPATH 設定：Linux vs Windows 平台差異

核心差異

正確說明

**原文稱「Windows 平台下的 Tomcat 不行，必須手工添加到 CLASSPATH 環境變量中」是錯誤資訊。**

• Tomcat 所有版本 (Windows/Linux) **啟動腳本均會自動掃描 $CATALINA_HOME/lib (或 %CATALINA_HOME%\\lib) 下的所有 JAR/ZIP 檔案並加入系統類載入器**。
• 共用類庫 (JDBC 驅動、JNDI 實作、Logging API 等) **直接放入 lib/ 即可**，重啟 Tomcat 生效。
• **不要**設定系統環境變數 CLASSPATH，會干擾 Tomcat 類載入機制，導致版本衝突、類找不到等詭異問題。

Tomcat 類載入器架構 (簡化)

Bootstrap ClassLoader
  ↑ (JAVA_HOME/jre/lib)
System ClassLoader
  ↑ (CATALINA_HOME/bin/bootstrap.jar, tomcat-juli.jar)
Common ClassLoader  ← $CATALINA_HOME/lib/*.jar  (共用庫)
  ↑
Webapp ClassLoader (每個 Web 應用獨立)
  ↑ (WEB-INF/classes, WEB-INF/lib/*.jar)

最佳實務

1. 共用類庫 (多個 Webapp 共用) → $CATALINA_HOME/lib/
2. 應用專用類庫 → WEB-INF/lib/ (隨 WAR 部署，隔離版本)
3. 類別檔案 → WEB-INF/classes/
4. 避免 修改系統 CLASSPATH、JAVA_OPTS 加入 -classpath、將 JAR 放入 JRE lib/ext (已棄用機制)

驗證方式

# Linux
ps -ef | grep catalina
# 查看 java 命令列 -classpath 參數包含 lib/*.jar

# Windows
wmic process get commandline | findstr java
# 同理檢查 -classpath

總結

**Linux、Windows 同樣只需將 JAR 放入 $CATALINA_HOME/lib/，Tomcat 啟動自動載入。** 原文 Windows 需手動設定 CLASSPATH 的說法**不正確**，請勿遵循。