web.xml 配置錯誤排查指南：常見標籤未閉合與語法問題解決方案

在 Java Web 開發中，web.xml 作為核心部署描述符，任何語法錯誤都會導致應用啟動失敗。許多開發者在配置時遇到「急急急救」級別的報錯，實際上多半源於 XML 標籤未正確閉合、巢狀結構錯誤或拼寫錯誤。

常見錯誤類型與排查步驟

1. 標籤未閉合或拼寫錯誤

檢查所有起始標籤（如 <servlet>、<filter>、<welcome-file-list>）是否都有對應的結束標籤。XML 對大小寫敏感，<Servlet> 與 <servlet> 是不同的標籤。

2. 巢狀結構錯誤

確保元素嵌套符合 DTD/XSD 規範。例如 <servlet-mapping> 必須在 <servlet> 之後定義，<filter-mapping> 對應 <filter>。

3. 特殊字符未轉義

屬性值中包含 &、<、>、"、' 時需使用實體引用（&、< 等）。

快速定位錯誤的工具與技巧

• IDE 驗證：Eclipse、IntelliJ IDEA 會即時標紅語法錯誤，滑鼠懸停可見具體提示。
• 線上 XML 驗證器：將內容貼上至 XML Validation 等工具，快速定位行號。
• Tomcat 啟動日誌：catalina.out 或控制台輸出的 SAXParseException 會指明錯誤行列。

最佳實踐建議

1. 使用成熟的框架（Spring Boot 等）減少手寫 web.xml 的場景。
2. 採用版本控制，每次修改後先在本地驗證再提交。
3. 保留一份可用的基礎模板，新增配置時對照參考。

遇到報錯時，保持冷靜，按「檢查標籤閉合 → 核對巢狀順序 → 驗證特殊字符」三步走，多數問題可在幾分鐘內解決。