Apache Tomcat 安裝配置入門指南：從下載到部署Web應用

Apache Tomcat 是一款開源的 Java Servlet 容器，同時具備 HTTP Web 伺服器功能。它是 Java Web 開發與部署的標準運行環境之一，支援最新的 Servlet、JSP、WebSocket 等規範。

環境前置需求

• JDK (Java Development Kit)：Tomcat 運行需要 JRE，開發編譯需 JDK。建議安裝 JDK 8 或 11+ (LTS版本)。
  • 下載：Oracle JDK 或 OpenJDK (如 Adoptium Temurin)。
  • 配置環境變數：JAVA_HOME 指向 JDK 安裝目錄，PATH 添加 %JAVA_HOME%\bin。

Tomcat 下載與安裝 (Windows 為例)

1. 下載：訪問 官網，選擇版本 (如 9.0.x, 10.1.x)。下載 64-bit Windows zip (解壓版，推薦學習/開發) 或 exe (安裝版，含服務註冊)。
2. 解壓/安裝：
   • Zip 版：解壓至無中文、無空格路徑 (如 D:\Dev\apache-tomcat-9.0.85)。此目錄即 CATALINA_HOME。
   • Exe 版：按提示安裝，可選「Service Startup」安裝為系統服務，預設端口 8080。
3. 驗證：
   • 啟動：執行 bin\startup.bat (或啟動服務)。
   • 瀏覽器訪問 https://localhost:8080，出現 Tomcat 貓咪歡迎頁即成功。
   • 關閉：執行 bin\shutdown.bat (或停止服務)。

核心目錄結構解析

關鍵配置調整 (conf/server.xml)

1. 修改默認端口 (避免衝突)

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8" /> <!-- 建議加上 URIEncoding 防止中文參數亂碼 -->

常改為 80 (需管理員權限) 或 8081 等。

2. 配置虛擬主機與應用上下文

<Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
    <!-- 默認 ROOT 應用對應 webapps/ROOT -->
    
    <!-- 方式一：Context 配置外部目錄 (開發常用，不放入 webapps) -->
    <Context path="/myapp" docBase="D:/Projects/MyWebApp" reloadable="true" />
    
    <!-- 方式二：配置別名 (映射靜態資源目錄) -->
    <Context path="/static" docBase="D:/StaticResources" />
</Host>

• path：訪問路徑前綴 (如 /myapp 訪問 https://host:port/myapp/...)。
• docBase：應用實際物理路徑 (WAR包或解壓目錄)。
• reloadable="true"：開發模式，類文件變更自動重載，**生產環境必須設為 false**。

部署 Web 應用三種方式

1. 自動部署：將 WAR 包或項目目錄放入 webapps/，Tomcat 自動解壓部署。
2. 配置 Context (server.xml 或 conf/Catalina/localhost/xxx.xml)：指向任意磁盤路徑，適合開發調試，源碼修改即時生效 (配合 IDE 熱部署)。
3. Tomcat Manager App：啟用 manager-gui 角色用戶，訪問 /manager/html 圖形化部署/啟停/重載。

常見問題排查

• 啟動閃退：檢查 JAVA_HOME 是否正確；端口 8080 被佔用 (netstat -ano | findstr 8080)；日誌 logs/catalina.<日期>.log 查看堆疊信息。
• 中文亂碼：Connector 加 URIEncoding="UTF-8"；POST 請求在 Servlet 中 request.setCharacterEncoding("UTF-8")；資料庫連接串加 characterEncoding=utf8。
• JSP 修改不生效：清理 work/ 目錄；確認 reloadable="true" 或開發工具熱部署配置。

總結

掌握 Tomcat 目錄結構、核心配置 (server.xml)、部署機制與日誌分析，是 Java Web 開發者的必備基本功。開發階段善用 Context docBase 指向項目目錄配合 IDE 熱部署，能大幅提升開發效率；生產環境則關注性能調優、安全加固、集群負載均衡等進階配置。