Tomcat与Servlet、JSP、JDK的版本适配问题（解决访问出现404和500的问题）

最新推荐文章于 2025-03-11 19:38:16 发布

得过且过的勇者y

最新推荐文章于 2025-03-11 19:38:16 发布

阅读量1w

点赞数 15

分类专栏：后端文章标签： tomcat maven jdk java

本文链接：https://blog.csdn.net/qq_25046827/article/details/121490243

版权

后端专栏收录该内容

29 篇文章

订阅专栏

本文主要介绍了在使用Maven构建JavaWeb项目时遇到的Tomcat10.0.12与Servlet4.0.1版本不兼容问题，导致404和500错误。原因是Tomcat10开始使用Jakarta EE，而依赖使用的是javax.servlet包。解决方法包括降低Tomcat版本至9或以下，或者升级Servlet依赖至与Tomcat版本匹配的Jakarta包。此外，还对比了Servlet2.x和3.x规范的不同。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章目录

一、问题描述

最近在学习Maven创建Java Web项目的过程中，出现了配置Servlet后访问出现404和500的问题，如下

在这里插入图片描述

二、出现原因

在网上查了许多资料之后，我发现这是因为Tomcat版本的适配问题。

在Tomcat的官网中，我们可以看到不同版本的Tomcat适配的JDK、Servlet、Jsp以及EL的版本，如下：

在这里插入图片描述

由于我使用的是Tomcat10.0.12的版本，而我使用Maven导入的依赖如下

<dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
</dependency>
<dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>javax.servlet.jsp-api</artifactId>
      <version>2.3.2-b01</version>
</dependency>

这将导致Tomcat版本无法兼容Servlet版本（tomcat10将JavaEE更换成了Jakarta® EE，所以原Servlet包"javax.servlet.“更改成了"jakarta.servlet.”），我们在500的图中根本原因的第一行也可以看到：Register cannot be cast to class Jakarta.servlet.Servlet，即我使用的是Servlet是javax包里的，而Tomcat能够识别（适配）的是Jakarta包里的，而javax包里的Servlet类无法转换为Jakarta包里的Servlet类，所以显示了例外情况里的第一行：类cn.ken.controller.Register不是Servlet。

三、解决方法

既然是由于Tomcat版本与Servlet版本不匹配造成，那么自然就有对应的两种解决方法

1、降低Tomcat版本

因为tomcat10才改成Jakarta，故只需将Tomcat版本降低到10以下，例如Tomcat9等。

当然还要结合具体情况进行分析，让使用的Tomcat版本能够匹配自己使用的JSP或JDK等的版本

除了通过下载安装新的Tomcat（这显然比较麻烦），我们也可以通过Maven安装低版本的Tomcat插件来运行，具体操作可见Maven继承Tomcat插件

2、提高Servlet版本

将pom.xml中的Servlet更换为最新的依赖，与使用的Tomcat匹配，如下

<dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-servlet-api</artifactId>
      <version>10.0.12</version>
</dependency>
<dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat-jsp-api</artifactId>
      <version>10.0.12</version>
</dependency>

重新加载Maven变更后即可成功访问Sevrlet

四、相关内容

对于 JDK，高版本的Tomcat是可以正常使用低版本的JDK，反之则不行

JAVA servlet 2.x规范：
　　项目目录结构必须要有WEB-INF，web.xml等文件夹和文件
　　在web.xml中配置servlet,filter,listener，以web.xml为java web项目的统一入口

JAVA servlet 3.x规范：
　　项目中可以不需要WEB-INF，web.xml等文件夹和文件
　　在没有web.xml文件的情况下，通过注解实现servlet，filter, listener的声明，例如
　　@WebServlet, @WebFilter,@WebListener，当使用注解时，容器自动进行扫描。