SpringBoot 3.0.0 M3 pom.xml中Tomcat Embed依赖引入失败问题

数据老陈

2026-8-28

问题原因

你使用的3.0.0-M3是Spring Boot 3的里程碑预览版本，该版本指定的Tomcat 10.0.21版本依赖未完全同步至公共仓库，直接拉取会出现找不到依赖的报错。
你的JSP依赖配置存在两处错误：一是错误添加了provided作用域，该配置仅适用于WAR包部署到外部Tomcat的场景，内嵌容器启动时会因为类路径下缺少Jasper引擎报错；二是缺少JSTL标签库依赖，使用JSP时大概率会出现标签解析失败的问题。
你对JSP的存放路径认知有误：内嵌Tomcat运行时无法直接读取resources目录下的JSP文件，必须遵循Java Web规范放在指定的webapp路径下。

解决步骤

替换Spring Boot版本为正式稳定版，避免预览版的依赖兼容问题，修改pom.xml中parent节点的版本配置：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.0.0</version>
    <relativePath/>
</parent>

修正JSP相关依赖配置，删除错误的scope配置，补充JSTL依赖（Spring Boot 3基于Jakarta EE，不要引入旧的javax包下的JSTL依赖）：

<!-- Tomcat Jasper JSP渲染引擎 -->
<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
</dependency>
<!-- JSTL标签库支持 -->
<dependency>
    <groupId>jakarta.servlet.jsp.jstl</groupId>
    <artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
</dependency>

在Spring Boot配置文件中添加视图解析配置，以application.properties为例：

# JSP文件存放前缀
spring.mvc.view.prefix=/WEB-INF/jsp/
# JSP文件后缀
spring.mvc.view.suffix=.jsp

调整JSP文件存放路径：在src/main目录下新建webapp/WEB-INF/jsp目录结构，将所有JSP文件移动到该目录下，不要存放在resources目录中。
打开IDEA右侧的Maven面板，点击刷新按钮重新拉取依赖，依赖拉取完成后即可正常启动项目。

特殊场景处理

如果你必须保留3.0.0-M3版本，不需要升级Spring Boot，可以手动指定tomcat-embed-jasper的可用版本，覆盖父POM的默认版本配置：

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-jasper</artifactId>
    <version>10.0.20</version>
</dependency>

不推荐在生产/学习环境使用里程碑(M)、快照(SNAPSHOT)版本，这类版本属于开发预览版，存在大量未修复Bug和依赖同步问题，优先选择带GA标识的正式发布版本。

内容的提问来源于stack exchange，提问作者CurlyFry