java - 在 Tomcat 9 上运行时在 Maven/Jersey Web 服务上获取 java.lang.ClassNotFoundException : jakarta. servlet.Filter

Question

使用以下资源在 Tomcat 9 服务器上运行时，出现错误 java.lang.ClassNotFoundException: jakarta.servlet.Filter下面是pom.xml文件

<modelVersion>4.0.0</modelVersion>

<groupId>com.telusko</groupId>
<artifactId>demorest</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>demorest</name>

<build>
    <finalName>demorest</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>2.5.1</version>
            <inherited>true</inherited>
            <configuration>
                <source>1.7</source>
                <target>1.7</target>
            </configuration>
        </plugin>
    </plugins>
</build>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.glassfish.jersey</groupId>
            <artifactId>jersey-bom</artifactId>
            <version>${jersey.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.glassfish.jersey.containers</groupId>
        <artifactId>jersey-container-servlet-core</artifactId>
        <!-- use the following artifactId if you don't need servlet 2.x compatibility -->
        <!-- artifactId>jersey-container-servlet</artifactId -->
    </dependency>
    <dependency>
        <groupId>org.glassfish.jersey.inject</groupId>
        <artifactId>jersey-hk2</artifactId>
    </dependency>
    
    
    <!-- https://mvnrepository.com/artifact/com.sun.jersey/jersey-core -->

    
    <!-- uncomment this to get JSON support
    <dependency>
        <groupId>org.glassfish.jersey.media</groupId>
        <artifactId>jersey-media-json-binding</artifactId>
    </dependency>
    
    -->
</dependencies>
<properties>
    <jersey.version>3.0.0-M6</jersey.version>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties> </project>

以下是带有 demorest 项目的 web.xml 文件。

<?xml version="1.0" encoding="UTF-8"?>
<!-- This web.xml file is not required when using Servlet 3.0 container,
     see implementation details http://jersey.java.net/nonav/documentation/latest/jax-rs.html -->
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <servlet>
        <servlet-name>Jersey Web Application</servlet-name>
        <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
        <init-param>
            <param-name>jersey.config.server.provider.packages</param-name>
            <param-value>com.telusko.demorest</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>Jersey Web Application</servlet-name>
        <url-pattern>/webapi/*</url-pattern>
    </servlet-mapping>
</web-app>

创建的资源文件如下:

package com.telusko.demorest;

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

/**
 * Root resource (exposed at "myresource" path)
 */
@Path("myresource")
public class MyResource {

    /**
     * Method handling HTTP GET requests. The returned object will be sent
     * to the client as "text/plain" media type.
     *
     * @return String that will be returned as a text/plain response.
     */
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String getIt() {
        return "Got it!";
    }
}

Answer 1

java.lang.ClassNotFoundException: jakarta.servlet.Filter

此类是 Servlet API 版本 5.0 的一部分，而后者又是 Jakarta EE 版本 9 的一部分。
和，

<jersey.version>3.0.0-M6</jersey.version>

这个 Jersey 版本基于 JAX-RS API 3.0 版，而后者又是 Jakarta EE 9 版的一部分。
和，

Tomcat 9 server

此 Tomcat 版本基于 Servlet API 版本 4.0，而后者又是 Java/Jakarta EE 版本 8 的一部分。
因此，总而言之，目标 JEE 版本不匹配，这给您带来了麻烦。您有 2 个选择:

将 Jersey 降级到 2.x 版。这个基于 JAX-RS API 版本 2.x，而后者又是 Java/Jakarta EE 版本 8 的一部分。

或者，将 Tomcat 升级到 10.x 版。这个基于 Servlet API 版本 5.0，它又是 Jakarta EE 版本 9 的一部分(它又提供了 JAX-RS API 版本 3.x，因此您可以使用预期的 Jersey 版本)。

技术原因是在从 Java/Jakarta EE 8 到 Jakarta EE 9 的这一步中 javax.*软件包已重命名为 jakarta.*包。因此，自 Jakarta EE 9 以来不再有向后兼容性。目标运行时本身(因此，Tomcat 本身)必须真正成为 Jakarta EE 9 使用的 API 的目标。
也可以看看:

Apache Tomcat - Versions

Tomcat 9 casting servlets to javax.servlet.Servlet instead of jakarta.servlet.http.HttpServlet (此答案包含 Tomcat 10+、Tomcat 9-、JEE 9+ 和 JEE 8- 的正确 pom.xml 声明的完整示例)。