chen
在開始編寫這篇文章之前，我們需要先了解一些背景知識。Tomcat 是一種流行的開源的 Java Servlet 容器，它允許開發者部署和管理基於 Java 的 Web 應用程序。Tomcat 在啓動過程中可能會遇到許多問題，其中之一就是當多個 web.xml 文件中的 servlet-mapping 有重複的 URI 模式時會拋出的 `IllegalStateException` 異常。這個錯誤通常意味着 Tomcat 在嘗試加載或初始化一個已經存在的 servlet，而這是不被支持的。
以下是一篇關於解決這個問題以及如何避免將來再次發生這種錯誤的指導性文章:
—
Tomcat 啟動失敗原因與解決方法 重複的 WEB-CONTEXT-PATH 設定問題
當您嘗試啟動 Apache Tomcat 伺服器時，如果出現了 `IllegalStateException` 錯誤訊息，這可能是因為您的應用程式中有重複的 WEB-INF/web.xml 中 servlet-mapping 的 URI 模式所引起的。這個錯誤可能會導致 Tomcat 無法正常啟動，並且在控制檯輸出中顯示類似以下的錯誤訊息:
java.lang.IllegalStateException: ContainerBase.addChild: start: org.apache.catalina.core.StandardContext addChild: org.apache.catalina.startup.HostConfig.deployWAR: context already added to parent: org.apache.catalina.core.ContainerBase.addChildInternal: start: ...
這個錯誤通常是因為您的應用程式中有兩個或多個不同的 WAR 檔案（或者 JAR 檔案）包含了相同的 `@WebServlet` 註釋或是 “ 和 “ XML 元素，這些元素映射到了同一個 URL 上。Tomcat 不允許這樣的配置，因為它會引起混亂和不確定的行為。
要解決這個問題，您可以採取以下步驟:
1. 檢查 WAR 檔案的內容: 使用 `jar -tvf .war` (Linux / macOS) 命令來查看 WAR 檔案中的所有資源。尋找是否有任何包含 `WEB-INF/web.xml` 的其他 JAR 檔案。如果有，請移除這些重複的 JAR 檔案，或者修改其中的 “ 以指向不同的 URL。
2. 清理 TOMCAT 的部署目錄: 如果已經在 Tomcat 上部署了 WAR 檔案，並且您發現了上述的問題，那麼需要從 Tomcat 的 `$TOMCAT_HOME/webapps` 目錄中刪除相應的 WAR 檔案及其相關資料夾。這樣可以清除舊版的部署並為新的乾淨部署做準備。
3. 確保每個 WEB-INF/web.xml 是獨立的: 確認每個 WAR 檔案中的 `WEB-INF/web.xml` 都是唯一的且沒有重複的 “。如果必須共用某些 servlets，考慮將它們提取到單獨的 JAR 檔案中，然後由所有的 WAR 檔案共用。
4. 檢視 @WebServlet 註釋的使用: 如果您的應用程式使用了 Spring MVC 或其他框架，檢查是否存在重複的 `@WebServlet` 註釋。這些註釋可能在不同組件中被重用，但卻導向了相同的根路徑。如果是這樣，請確保這些註釋的唯一性和一致性。
5. 更新部署腳本: 如果您有一個自動化的部署流程，例如 Jenkins CI/CD 管道，檢查這些腳本的正確性，特別是在合併來自不同分支的變更時。確保不會意外地引入重複的 servlet 配置。
6. 監控 Tomcat 日誌: 定期審查 Tomcat 的系統日誌，查找任何潛在的重複配置錯誤。這樣可以幫助您及早發現和解決未來可能的問題。
通過遵循這些最佳實踐，您可以避免在啟動 Tomcat 時出現 `IllegalStateException` 錯誤，並保持您的 Web 應用程式的健康運行。記住，預防勝於治療，因此在開發過程中就要注意這些細節。
