JavaWeb Servlet 配置詳解：web.xml 核心映射規則與容器匹配機制

Servlet 配置雙重結構

在 web.xml 中註冊 Servlet 需要兩組標籤配合：

<servlet>
    <servlet-name>MyServlet</servlet-name>
    <servlet-class>com.Servlet.MyServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>MyServlet</servlet-name>
    <url-pattern>/Servlet</url-pattern>
</servlet-mapping>

• <servlet>：定義邏輯名稱（servlet-name）與全限定類名（servlet-class）。
• <servlet-mapping>：將邏輯名稱映射至 URL 模式（url-pattern），兩處 servlet-name 必須完全一致。

三種 URL 模式匹配規則

特殊模式 / 定義默認 Servlet（處理所有未匹配請求），區別於 /*（攔截所有請求含靜態資源）。

容器查找優先級算法

1. 精確匹配：優先查找完全一致的 url-pattern。
2. 最長目錄匹配：精確匹配失敗，在目錄模式中選擇路徑最長者。
   例：/test/* vs /test/b/*，請求 /test/b 命中後者。
3. 擴展名匹配：目錄匹配失敗，按後綴匹配 *.ext。
4. 默認 Servlet：以上均無匹配，交給 / 處理。

常見誤區與避坑指南

• 區分 / 與 /*：
  / 僅作為最後兜底，不攔截 JSP/靜態資源；/* 會攔截所有請求，導致靜態資源（CSS/JS/圖片）無法訪問，需額外配置 <mime-mapping> 或使用 DefaultServlet。
• 大小寫敏感：URL 模式匹配區分大小寫，/Servlet 不匹配 /servlet。
• 多映射同一 Servlet：一個 <servlet> 可對應多個 <servlet-mapping>，實現多入口訪問同一處理邏輯。

註解式配置（Servlet 3.0+）

現代項目推薦使用 @WebServlet 註解替代 web.xml：

@WebServlet(
    name = "MyServlet",
    urlPatterns = {"/servlet/MyServlet", "*.do"},
    loadOnStartup = 1,
    initParams = {@WebInitParam(name = "config", value = "value")}
)
public class MyServlet extends HttpServlet { ... }

• urlPatterns 或 value 支持多模式，等價於多個 servlet-mapping。
• loadOnStartup > 0 表示容器啟動時實例化，數值越小優先級越高。

進階配置參數速查