嵌入式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
相关产品推荐
相关产品推荐

