Tomcat 服務器核心配置實戰：端口修改、虛擬目錄映射三種方式與最佳實踐

一、端口配置

編輯 conf/server.xml，修改 <Connector> 元素 port 屬性：

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

• 默認 8080，改為 80 可省去瀏覽器輸入端口（需管理員權限，Linux 需 root 或 setcap）。
• 修改後**必須重啟 Tomcat** 生效。

二、虛擬目錄映射三種方式

將磁盤目錄映射為 Web 訪問路徑（如 https://host:port/appName/）。

方式 1：server.xml 配置 <Context>（不推薦生產）

<Host name="localhost" appBase="webapps" ...>
    <Context path="/JavaWebApp" docBase="F:\JavaWebDemoProject" />
</Host>

• path：虛擬路徑，**必須以 / 開頭**。
• docBase：項目物理絕對路徑或相對 appBase 路徑。
• 缺點：修改需重啟 Tomcat，Tomcat 6.0+ 官方不推薦。

方式 2：放入 webapps 目錄（最簡單，開發常用）

• 將項目 WAR 包或解壓目錄直接放入 $CATALINA_HOME/webapps/。
• Tomcat 自動掃描部署，虛擬路徑默認為目錄/WAR 名（如 myapp.war → /myapp）。
• 支持熱部署（開發模式下修改 JSP/類文件自動重載，需配置 Context reloadable="true"）。

方式 3：conf/Catalina/localhost/ 下添加 XML 文件（推薦生產/靈活部署）

1. 在 conf/Catalina/localhost/ 創建 myapp.xml（文件名即虛擬路徑 /myapp）。
2. 內容：

<Context docBase="F:\JavaWebDemoProject" reloadable="true" />

• 優點：修改 XML **無需重啟 Tomcat**，Tomcat 會定期掃描該目錄動態部署/更新。
• 支持屬性：docBase、reloadable、path（可覆蓋文件名）、workDir 等。

三、部署驗證與常見問題

1. 瀏覽器訪問 https://localhost:8080/JavaWebApp/1.jsp 驗證映射生效。
2. 路徑大小寫敏感：Linux 區分大小寫，docBase、path 需精確匹配。
3. 多應用隔離：各應用獨立 Context，類加載器隔離，避免 Jar 衝突。
4. 生產建議：方式 2/3 結合，WAR 包放 webapps，外部配置（數據源、屬性文件）通過 Context XML 注入 Environment 或 Resource，實現「構建包不變，環境配置外置」。

聲明

本文整理自「孤傲蒼狼」博主 JavaWeb 學習筆記，致敬原創分享。