Eclipse 解決 javax.servlet.http.HttpServlet 找不到錯誤：添加 Servlet API 庫完整步驟

問題現象

在 Eclipse 中開發 Java Web 項目時，繼承 HttpServlet 的類報錯：The type javax.servlet.http.HttpServlet cannot be resolved. It is indirectly referenced from required .class files。原因是項目構建路徑缺少 Servlet API 庫。

解決方案：通過 Eclipse Build Path 添加 Server Runtime 庫

以下以 Tomcat 為例，步驟通用於 Jetty、JBoss 等容器。

步驟 1：右鍵項目 → Build Path → Configure Build Path

步驟 2：選中 Libraries 標籤 → Add Library

步驟 3：選擇 Server Runtime → Next

步驟 4：選擇已配置的運行時（如 Apache Tomcat 9.0）→ Finish

步驟 5：點擊 Apply and Close，錯誤消失

替代方案：Maven/Gradle 依賴管理（推薦）

現代項目建議使用構建工具管理依賴，避免 IDE 強耦合。

Maven (pom.xml)

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope> <!-- 容器已提供，不打包進 WAR -->
</dependency>

Gradle (build.gradle)

dependencies {
    providedCompile 'javax.servlet:javax.servlet-api:4.0.1'
}

刷新項目後自動下載 Jar 並添加到構建路徑。

常見誤區

• 手動複製 servlet-api.jar 到 WEB-INF/lib：會導致部署時與容器自帶 Jar 衝突，拋出 LinkageError。
• 使用 javaee-api 而非 servlet-api：javaee-api 包含所有 Java EE 接口，體積大且版本易衝突，Web 項目僅需 servlet-api。
• Scope 設置為 compile：導致打包進 WAR，同樣引發衝突，必須用 provided。

驗證方法

// 測試類
@WebServlet("/test")
public class TestServlet extends HttpServlet { // 不再報錯
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        resp.getWriter().write("Servlet API 已正確加載！");
    }
}

通過以上步驟，徹底解決 HttpServlet 找不到問題，規範依賴管理，避免部署衝突。