Tomcat 指定運行時 JDK 版本完整指南（Windows/Linux）

Tomcat 指定運行時 JDK 版本完整指南（Windows/Linux）

Tomcat 啟動腳本會讀取 JAVA_HOME 與 JRE_HOME 環境變數決定使用哪個 JDK。若伺服器安裝多個 JDK，或不想污染系統環境變數，可直接修改 Tomcat bin 目錄下的啟動腳本，指定專屬 JDK 路徑。本文提供 Windows 與 Linux 兩種作業系統的完整操作步驟與原理解析。

核心原理

1. startup.bat/sh 呼叫 catalina.bat/sh。
2. catalina.bat/sh 呼叫 setclasspath.bat/sh 解析 JAVA_HOME/JRE_HOME。
3. 因此，在 setclasspath.bat/sh 開頭硬編碼這兩個變數，即可鎖定 Tomcat 使用的 JDK，且不需設定系統環境變數。

Windows 環境設定

1. 解壓 Tomcat 至任意目錄，例如 D:\apache-tomcat-9.0。
2. 編輯 bin\setclasspath.bat，在檔案最頂端（第一行有效指令前）新增：

set JAVA_HOME=D:\Program Files\Java\jdk1.8.0_202
set JRE_HOME=D:\Program Files\Java\jdk1.8.0_202\jre

3. 儲存，雙擊 startup.bat 啟動，Tomcat 將使用指定 JDK。

Linux 環境設定

1. 解壓 Tomcat，例如 /opt/apache-tomcat-9.0。
2. 編輯 bin/setclasspath.sh，在檔案最頂端（shebang 之後）新增：

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export JRE_HOME=/usr/lib/jvm/java-8-openjdk-amd64/jre

3. 賦予執行權限：chmod +x bin/*.sh。
4. 啟動：./bin/startup.sh。

替代方案：修改 catalina.bat/sh

同樣可在 catalina.bat 或 catalina.sh 開頭設定 JAVA_HOME，效果相同。但 setclasspath 是專門解析 JDK 路徑的腳本，修改此處語意更清晰，且不影響 catalina 其他邏輯。

驗證 JDK 版本

1. 啟動 Tomcat 後，查看 logs/catalina.out（Linux）或主控台輸出（Windows）。
2. 搜尋 Java Home 或 JVM Version 關鍵字，確認是否為預期版本。
3. 或在管理應用 /manager/status 中查看 JVM 詳細資訊。

常見問題排查

最佳實踐建議

• 生產環境建議使用 JAVA_HOME 系統環境變數統一管理，便於升級與巡檢。
• 開發/測試多版本共存時，採用本文腳本硬編碼方式隔離環境。
• 搭配 CATALINA_BASE 實現多實例部署，每實例可獨立指定 JDK。