Tomcat 配置詳解：server.xml 中 appBase 與 Deploy Path 的關係

問題釐清

用戶詢問 server.xml 中 <Host> 標籤的 webapps 屬性（實為 appBase）與 Eclipse/IDEA 中 Server Locations 的 Deploy Path 關係。

核心概念區分

server.xml 關鍵配置示例

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
    <Context path="" docBase="ROOT" />
    <Valve className="org.apache.catalina.valves.AccessLogValve" ... />
</Host>

• appBase="webapps"：默認值，即 $CATALINA_BASE/webapps
• Tomcat 啟動時會掃描此目錄下的 WAR 包與目錄並自動部署

IDE Deploy Path 作用機制

以 Eclipse 為例，Server Locations 三種模式：

1. Use Tomcat installation：部署到 $CATALINA_HOME/webapps（需寫入權限）
2. Use workspace metadata：部署到工作區 .metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps（默認，不污染安裝目錄）
3. Use custom location：用戶指定目錄，即 Deploy Path**

IDE 會將專案編譯後的類文件、資源文件、web.xml 等按 Web 應用結構複製到 Deploy Path 對應目錄，Tomcat 按 appBase 掃描並加載。

關係總結

• appBase 是 Tomcat 運行時 讀取應用的根目錄
• Deploy Path 是 IDE 構建發布產物 的目標目錄
• 兩者必須一致（或 Deploy Path 在 appBase 之下），Tomcat 才能加載到 IDE 發布的應用
• 生產環境無 IDE，直接將 WAR 放入 appBase 目錄即可

常見坑點

• IDE 切換 Server Locations 模式後，需清理舊發布目錄並重新發布
• 多模塊專案需確保模塊發布路徑正確映射到同一 Web 應用根目錄
• docBase 可覆蓋單個 Context 的實際路徑，優先級高於 appBase