您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

Windows 下 Java 環境變量配置與 Tomcat 9 安裝全流程圖解

編輯：Java 綜合教學

前言：開發環境搭建的基石

在 Windows 上進行 Java Web 開發，JDK 與 Tomcat 的正確安裝配置是起跑線。本文提供最新、最全、避坑指南，涵蓋環境變量設置、Tomcat 服務安裝、端口修改、常見錯誤排查，適合初學者與遷移環境的開發者。

第一部分：JDK 安裝與環境變量配置

1.1 下載安裝 JDK

官網：Oracle JDK Downloads (建議 LTS 版本：8, 11, 17, 21)
安裝路徑建議：C:\Program Files\Java\jdk-17 (無空格、無中文、非系統盤根目錄)
安裝過程保持默認選項，記住安裝路徑

1.2 配置系統環境變量 (管理員權限)

路徑：此電腦 → 右鍵屬性 → 高級系統設置 → 環境變量

變量名	變量值 (示例)	說明
JAVA_HOME	`C:\Program Files\Java\jdk-17`	JDK 安裝根目錄 (到 bin 上一層)，核心變量
CLASSPATH	`.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar`	. 代表當前目錄，JDK 9+ 可省略 dt.jar/tools.jar
Path	`%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin`	追加到現有 Path 末尾，分號分隔。JDK 9+ 無獨立 jre 目錄

⚠ 注意：JDK 9 起移除獨立 JRE 目錄，%JAVA_HOME%\jre\bin 無需配置。建議僅配置 %JAVA_HOME%\bin。

1.3 驗證安裝

打開新的 CMD 窗口 (舊窗口不生效)：

> java -version
java version "17.0.x" ...
> javac -version
javac 17.0.x
> java -version
// 輸出版本信息即成功，若提示「不是內部命令」請檢查 Path 配置

第二部分：Tomcat 9 安裝與配置

2.1 下載解壓

官網：Apache Tomcat 9 → Core: 64-bit Windows zip
解壓至無空格路徑，如：D:\DevTools\apache-tomcat-9.0.x

2.2 配置 Tomcat 環境變量 (可選但推薦)

變量名	變量值 (示例)	說明
CATALINA_HOME	`D:\DevTools\apache-tomcat-9.0.x`	Tomcat 安裝根目錄
CATALINA_BASE	`%CATALINA_HOME%`	多實例部署時區分，單實例同 HOME
Path	`%CATALINA_HOME%\bin`	追加，使 startup.sh/batalin 命令全局可用

CLASSPATH 無需添加 servlet-api.jar，Web 應用自帶依賴，全局添加反而易導致版本衝突。

2.3 安裝為 Windows 服務 (推薦生產/長期運行)

> cd /d %CATALINA_HOME%\bin
> service.bat install Tomcat9
// 成功輸出：The service 'Tomcat9' has been installed.

服務名可自定義：service.bat install MyTomcat
安裝後可在 services.msc 中設置「自動啟動」
管理命令：Tomcat9.exe //MS// (監視器)、Tomcat9 //ES// (編輯服務參數)

2.4 啟動驗證

方式一：服務管理器啟動「Apache Tomcat 9.0 Tomcat9」
方式二：CMD 執行 startup.bat (前台運行，關閉窗口即停止)

瀏覽器訪問：https://localhost:8080

出現「If you're seeing this page, you've successfully installed Tomcat. Congratulations!」即成功。

第三部分：常用配置調優

3.1 修改默認端口 (8080 → 80/8088/其他)

編輯 %CATALINA_HOME%\conf\server.xml：

<Connector port="8088" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

修改後重啟 Tomcat 生效。端口 < 1024 需管理員權限，建議用 8088/8081 等。

3.2 JVM 參數調優 (setenv.bat)

創建 %CATALINA_HOME%\bin\setenv.bat (Windows 不識別 setenv.sh)：

set JAVA_OPTS=-server -Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m -Dfile.encoding=UTF-8

-server：服務器模式 JIT 優化
-Xms/Xmx：堆初始/最大值，建議設相同避免震蕩
-Dfile.encoding=UTF-8：強制 UTF-8，防止中文亂碼

3.3 部署項目 (三種方式)

webapps 目錄：將 WAR 包或解壓目錄放入 webapps/，自動熱部署
server.xml 配置 Context：在 <Host> 下添加 <Context path="/myapp" docBase="D:/projects/myapp" />
Catalina/localhost/xxx.xml：在 conf/Catalina/localhost/ 創建 myapp.xml，內容同 Context 配置 (推薦，不污染 server.xml)

第四部分：常見問題排查

現象	可能原因	解決方案
啟動閃退 / 8080 無響應	端口被佔用 (常見: Oracle 佔 8080)	修改 server.xml 端口或 `netstat -ano \| findstr 8080` 找到 PID 杀进程
中文亂碼	Tomcat 默認 ISO-8859-1	server.xml Connector 添加 `URIEncoding="UTF-8"` + setenv.bat `-Dfile.encoding=UTF-8`
服務安裝失敗	無管理員權限 / 路徑含空格	以管理員運行 CMD / 重新安裝至無空格路徑
ClassNotFound: Servlet	手動把 servlet-api.jar 放入 CLASSPATH	移除 CLASSPATH 中的 servlet-api.jar，Web 應用自帶依賴
HTTPS 配置報錯	keystore 路徑/密碼錯誤	檢查 server.xml SSL Connector 的 keystoreFile/keystorePass

第五部分：目錄結構速覽

apache-tomcat-9.0.x/
├── bin/          # 啟動/關閉腳本、服務安裝、setenv.bat
├── conf/         # 核心配置: server.xml, web.xml, tomcat-users.xml, context.xml
├── lib/          # Tomcat 運行依賴 jar (servlet-api, jsp-api 等)
├── logs/         # 日志: catalina.out, localhost.xxx.log, access_log
├── webapps/      # 默認應用部署目錄 (ROOT, manager, host-manager)
├── work/         # JSP 編譯生成的 Servlet 源碼/類文件 (可安全刪除)
└── temp/         # 臨時文件