萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 頁面使用 JSTL 報 ClassNotFoundException 解決方案

問題現象

在 JSP 頁面引入 JSTL 核心標籤庫:

<%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>

啟動 Tomcat 訪問頁面,拋出異常堆疊:

org.apache.jasper.JasperException: java.lang.ClassNotFoundException: org.apache.jsp.xxx_jsp
...
root cause: java.lang.ClassNotFoundException: org.apache.jsp.xxx_jsp

乍看像是 JSP 編譯失敗,實則多數是 **Tomcat 缺少 JSTL 實作 JAR 包**導致標籤庫解析失敗,進而引發編譯錯誤。

根本原因

  • JSTL API(標準介面)包含在 javax.servlet.jsp.jstl-api 或 jstl-api 中。
  • **實作類**(如 Apache 標準實作 javax.servlet.jsp.jstl.core.LoopTagSupport 等)位於獨立 JAR:javax.servlet.jsp.jstl-impl 或舊版 standard.jar + jstl.jar。
  • Tomcat **預設不內建 JSTL 實作**,需手動放入 $CATALINA_HOME/lib 或專案 WEB-INF/lib。

解決方案

方案一:專案級依賴(推薦,Maven/Gradle)

<!-- Maven 依賴 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>
<!-- 或較新版 Jakarta EE 命名空間 -->
<dependency>
    <groupId>org.glassfish.web</groupId>
    <artifactId>jakarta.servlet.jsp.jstl</artifactId>
    <version>2.0.0</version>
</dependency>

打包 WAR 時會自動置入 WEB-INF/lib,避免伺服器層面污染。

方案二:Tomcat 全域安裝(適用共享庫場景)

  1. 下載 jstl-1.2.jar(或 jakarta.servlet.jsp.jstl-api + jakarta.servlet.jsp.jstl-impl)。
  2. 複製到 $CATALINA_HOME/lib 目錄。
  3. **重啟 Tomcat** 生效。
提示:Tomcat 9+ / 10+ 對應 Jakarta EE 9/10,套件名稱從 javax.* 變為 jakarta.*,請根據目標伺服器版本選擇正確座標。

驗證步驟

  1. 確認 JAR 存在於類路徑(專案 lib 或 Tomcat lib)。
  2. 清除 Tomcat work/Catalina/localhost/專案名 編譯緩存。
  3. 重新部署並訪問頁面,<c:forEach> 等標籤應正常解析。

常見誤區

  • 只放 jstl-api.jar 沒放實作 JAR → 同樣報 ClassNotFoundException。
  • 同時放舊版 standard.jar 與新版 jstl-1.2.jar → 類衝突,建議二選一。
  • JSP 頁面 taglib uri 寫錯(如漏掉 https:// 或版本號),導致容器找不到對應 TLD。
copyright © 萬盛學電腦網 all rights reserved