解決 Eclipse「The superclass javax.servlet.http.HttpServlet was not found」構建路徑缺失問題

Eclipse Web 項目報錯：HttpServlet 類未找到，一分鐘修復

錯誤現象

The superclass "javax.servlet.http.HttpServlet" was not found on the Java Build Path

Servlet API 包未加入項目構建路徑，導致編譯器無法解析 HttpServlet 父類。

根因

• Dynamic Web Project 未關聯 Servlet 容器運行時庫
• 手動創建的 Java Project 缺少 servlet-api.jar
• Maven/Gradle 依賴 scope 錯誤（如 compile 而非 provided）

解決方案（按推薦順序）

方案一：配置 Server Runtime（Eclipse 內置最佳）

1. 右鍵項目 → Build Path → Configure Build Path
2. 選中 Libraries 標籤 → Add Library...
3. 選擇 Server Runtime → Next
4. 選中已配置的 Tomcat/JBoss/WebLogic 等 → Finish
5. Apply and Close → 項目自動重新構建，錯誤消失

原理：Server Runtime 自動包含容器 lib/servlet-api.jar，且標記為「系統庫」，不會打包進 WAR。

方案二：Maven 項目添加 provided 依賴

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>  <!-- Tomcat 9/10: 4.0.x; Tomcat 8: 3.1.0 -->
    <scope>provided</scope>  <!-- 關鍵：編譯期需要，運行期由容器提供 -->
</dependency>

• 執行 Maven → Update Project 強制刷新
• 確保 pom.xml 無版本衝突

方案三：手動添加 servlet-api.jar（不推薦，難維護）

1. 從 Tomcat 安裝目錄 lib/servlet-api.jar 複製到項目 WebContent/WEB-INF/lib/
2. 右鍵項目 → Build Path → Add JARs → 選中該 JAR
3. 缺點：不同容器版本不一致、易衝突、打包進 WAR 體積增大

驗證修復

// 測試代碼
public class TestServlet extends HttpServlet {
    @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
            throws ServletException, IOException {
        resp.getWriter().write("Servlet API OK");
    }
}

無紅叉、無錯誤標記即修復成功。

常見誤區

總結

首選 Server Runtime，自動匹配容器版本、零配置、不侵入項目依賴。Maven 項目務必用 provided scope。這是 Eclipse Web 開發的「必修課」，一次配置，終身受益。