您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

JSP 入門系列：Tomcat 3.2/4.x/5.x 安裝配置與驗證最簡教程

編輯：Java 相關知識

前言

Tomcat 是 Servlet/JSP 參考實現，也是初學者最佳實戰容器。本文針對 Tomcat 3.x/4.x/5.x 時代版本，梳理最精簡的「下載 → 解壓 → 環境變量 → 啟動 → 驗證 → 關閉」流程，現代版本 (Tomcat 9/10/11) 同理可循，核心差異僅在目錄結構與預設端口。

一、下載與解壓

官網：https://tomcat.apache.org/ → Download → 選擇版本 → Core: zip/tar.gz (解壓版，推薦) 或 Windows Service Installer (安裝版)
解壓至無中文/空格路徑，如 D:\Tomcat5 或 /opt/tomcat5

二、環境變量配置 (Windows 圖形界面)

桌面「我的電腦」右鍵 → 屬性 → 高級 → 環境變量
系統變量 → 新建：

變量名: JAVA_HOME
變量值: C:\Java\jdk1.5.0_06   # 指向 JDK 根目錄 (含 bin、lib)

變量名: CATALINA_HOME   # 或 TOMCAT_HOME
變量值: D:\Tomcat5        # 指向 Tomcat 解壓根目錄

編輯系統變量 Path，追加 %JAVA_HOME%\bin;%CATALINA_HOME%\bin
確定所有對話框，**重新打開 CMD** 生效

三、啟動與驗證

CMD 進入 %CATALINA_HOME%\bin
運行 startup.bat (Windows) 或 ./startup.sh (Linux)
控制台輸出 Server startup in xxx ms
瀏覽器訪問 https://localhost:8080/ (Tomcat 3/4/5/6/7/8/9 默認端口均為 8080)
見到 Tomcat 貓咪歡迎頁 → 點擊 JSP Examples、Servlet Examples 運行內建範例

四、關閉

CMD 執行 shutdown.bat (Windows) 或 ./shutdown.sh (Linux)
或直接關閉啟動的 CMD 視窗 (非優雅關閉，可能遺留臨時文件)

五、常見問題速查

現象	原因	解決
雙擊 startup.bat 閃退	JAVA_HOME 未設或指向 JRE	設置 JAVA_HOME 指向 JDK 根目錄
瀏覽器 404 / 無法訪問	端口 8080 被佔用、防火牆攔截	netstat -ano \\| findstr :8080 找佔用進程、修改 server.xml port、放行防火牆
JSP 範例報 500 / 類找不到	JDK 版本過低、tools.jar 缺失	升級 JDK 1.5+、確保 JAVA_HOME 指向 JDK
中文亂碼	URIEncoding 未設、頁面 encoding 不一致	server.xml Connector 加 URIEncoding="UTF-8"、JSP 頁面 pageEncoding="UTF-8"

六、現代版本關鍵差異提示 (Tomcat 9/10/11)

Servlet API 包名變更： javax.servlet.* → jakarta.servlet.* (Tomcat 10+ / Servlet 5+)
目錄結構： common/lib → lib，server/lib、shared/lib 移除
配置文件： context.xml 功能增強、server.xml 默認啟用 NIO (protocol="org.apache.coyote.http11.Http11NioProtocol")
最低 JDK： Tomcat 9 → JDK 8，Tomcat 10/11 → JDK 11

結語

Tomcat 安裝配置的核心始終是 JAVA_HOME 指向 JDK、CATALINA_HOME 指向 Tomcat、端口無衝突、編碼統一 UTF-8。初學者建議直接使用 Tomcat 9/10 + OpenJDK 11/17 LTS + IDE 整合 (IntelliJ IDEA / Eclipse / VS Code)，跳過手動環境變量配置，專注於 Servlet/JSP 核心語法與 Web 應用架構學習。