一、问题描述

最近在学习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,当使用注解时,容器自动进行扫描。

Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐