You need to enable JavaScript to run this app. 嵌入式Tomcat9环境下JSP页面JSTL核心标签URI解析失败问题求助
优惠活动
大模型
产品
解决方案
定价
更多

嵌入式Tomcat9环境下JSP页面JSTL核心标签URI解析失败问题求助

嵌入式Tomcat 9 环境下JSTL URI解析错误修复方案

典型报错:The absolute uri: [http://java.sun.com/jsp/jstl/core] cannot be resolved in either web.xml or the jar files deployed with this application

针对适配Servlet 4.0、JSP 2.3规范的Tomcat 9.0.35嵌入式环境,该错误的根因和修复步骤如下:

核心根因定位

  • 依赖冲突:同时引入javax.servlet:jstl:1.2和javax.servlet.jsp.jstl:jstl-api:1.2两个包。其中jstl:1.2本身包含完整API与实现、内嵌对应TLD描述文件,和单独引入的jstl-api会产生类冲突,导致TLD文件加载异常。
  • 嵌入式Tomcat扫描配置缺失:自定义TomcatRunner启动时,若未给StandardContext开启TLD扫描开关,哪怕jar包已经放在WEB-INF/lib路径下,JSP引擎也不会解析jar包内META-INF下的taglib描述文件,自然无法匹配对应的URI。
  • 类加载隔离问题:若将JSTL相关依赖错误设置为provided作用域,会导致JSTL的类无法和嵌入式Tomcat的JSP引擎处于同一类加载上下文,触发URI解析失败。

可直接复用的修复步骤

调整Maven依赖,去除冗余

删除重复引入的JSTL API包,按照规范设置依赖作用域:

<!-- Servlet/JSP API 由嵌入式Tomcat提供,设置provided作用域即可 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>javax.servlet.jsp-api</artifactId>
    <version>2.3.3</version>
    <scope>provided</scope>
</dependency>
<!-- 仅保留完整的JSTL 1.2实现包,运行时生效,无需设置provided -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>

注意:不要引入任何taglib/standard相关依赖,该类包是JSTL 1.1及更早版本的实现,和1.2规范不兼容。

补全嵌入式Tomcat启动类的必要配置

在创建Web应用的StandardContext时,显式开启TLD扫描开关:

// 初始化嵌入式Tomcat的Web应用上下文
StandardContext ctx = new StandardContext();
// 关键配置:允许解析jar包内的TLD文件
ctx.setProcessTlds(true);
// 关键配置:开启类路径下的jar包扫描
ctx.setScanClassPath(true);
// 关键配置:支持WEB-INF目录下的资源访问
ctx.setAddWebinfClassesResources(true);
// 绑定Web应用的根路径
ctx.setDocBase(webAppBaseDir.getAbsolutePath());

不需要在web.xml中手动配置<taglib>节点,4.0版本的web.xml符合Servlet规范,JSTL的URI会通过TLD扫描自动识别匹配。

开启TLD扫描跟踪日志

如果调整配置后仍复现错误,可以开启Tomcat JSP引擎的调试日志,定位具体扫描失败的原因:

// 在Tomcat启动类中设置日志级别
Logger.getLogger("org.apache.jasper").setLevel(Level.FINE);
Logger.getLogger("org.apache.catalina.startup.TldConfig").setLevel(Level.FINE);

日志会输出所有扫描到的TLD文件路径、每个TLD声明的taglib URI,可以直接确认http://java.sun.com/jsp/jstl/core对应的TLD是否被正常加载,以及加载失败的具体原因(比如jar包路径错误、类加载隔离不匹配等)。

最小可运行应用结构

适配上述环境的嵌入式Tomcat项目结构如下,可直接作为参考模板:

  • 项目根目录下存放TomcatRunner启动类
  • src/main/webapp/WEB-INF/web.xml使用Servlet 4.0 schema配置
  • JSP页面按照原有写法引入核心标签库:<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
  • 构建后的WEB-INF/lib目录下仅保留jstl-1.2.jar,无其他重复的JSTL相关依赖

内容的提问来源于stack exchange,提问作者Cédric Dutoit

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 22:45:04