[Servlet] Tomcat10.0.82 构建Servlet类报错：HelloServlet cannot be cast to class jakarta.servlet错误分析与解决方法

问题描述

今日运行第一个Servlet程序时报了一个错误：HTTP状态 500 - 内部服务器错误、类HelloServlet不是Servlet、HelloServlet cannot be cast to class jakarta.servlet，如下图。

查阅了其他博主的资料发现大多数博主的解决办法都不太清楚，或者说不太实用，只好自己捣鼓捣鼓。有个博主提到：

这是因为使用了最新的tomcat10，而tomcat10有个最大的变动就是Tomcat 10 m1将JavaEE也换成了Jakarta® EE，Jakarta® EE较以前的JavaEE有一个非常非常重要的更新：包名不再是"javax.servlet.“而是改成了"jakarta.servlet.

解决方法

根据这个博主的说法，因为我使用的Tomcat是最新版，而且依赖的包名改变了，那么是不是依赖的jar包也要最新的？由于我是在Maven环境下构建的Servlet项目，于是我想到去更新我的dependency。

打开Maven仓库，搜索这两个artifactID。servlet-api 和 servlet.jsp。

两份dependency代码如下。

<!-- https://mvnrepository.com/artifact/org.apache.tomcat/tomcat-servlet-api -->
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-servlet-api</artifactId>
    <version>10.0.8</version>
</dependency>

<!-- https://mvnrepository.com/artifact/org.apache.tomcat/tomcat-jsp-api -->
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-jsp-api</artifactId>
    <version>10.0.8</version>
</dependency>

将原本的dependency换成新的，刷新一下Maven，再打开HelloServlet类，手动修改导入的java类，将javax修改为jakarta。

最后重新启动Tomcat，根据在web.xml注册的映射地址尝试打开Servlet程序，截图如下。

成功解决问题。

---

如果是非Maven环境下使用Tomcat10，可以自行下载jar包导入到项目中。

下载完两个jar包之后导入到项目所在的目录下，再在idea里添加下jar包即可。

一些建议

有些博主提到可以通过降低Tomcat的版本来解决问题，比如使用Tomcat9。如果你学习Servlet的参考教程配置的环境是Tomcat9，那么我建议最好也使用Tomcat9入门，这样在学习前期可以避免很多不必要的问题。对这些知识了解到一定深度之后，再去了解新版本的特性，将之前学习的内容移植到新版本上也会更加容易。当然，如果你想增加一点学习的难度，使用Tomcat10进行接下来的学习是个不错的选择。

我的代码

项目根目录下的pom.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>Servlet</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>servlet-01</module>
    </modules>

    <properties>
        <maven.compiler.source>15</maven.compiler.source>
        <maven.compiler.target>15</maven.compiler.target>
    </properties>

    <dependencies>

        <!-- https://mvnrepository.com/artifact/org.apache.tomcat/tomcat-servlet-api -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-servlet-api</artifactId>
            <version>10.0.8</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.apache.tomcat/tomcat-jsp-api -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jsp-api</artifactId>
            <version>10.0.8</version>
        </dependency>

    </dependencies>

</project>

webapp目录下的web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
                            http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0"
         metadata-complete="true">
    
    <!--注册Servlet-->
    <servlet>
        <servlet-name>Hello</servlet-name>
        <servlet-class>com.Shawn.servlet.HelloServlet</servlet-class>
    </servlet>
    <!--Servlet的请求路径-->
    <servlet-mapping>
        <servlet-name>Hello</servlet-name>
        <url-pattern>/hello</url-pattern>
    </servlet-mapping>

</web-app>

HelloServlet.java

package com.Shawn.servlet;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

public class HelloServlet extends HttpServlet {
    
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("Hello,Servlet!");
        PrintWriter writer = resp.getWriter();
        writer.print("Hello,Servlet");
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        doGet(req, resp);
    }
}