tomcat11出现的ServletContextListener的问题

Question

tomcat升级到11之后启动出现java.lang.NoClassDefFoundError: javax/servlet/ServletContextListener的问题，原Servlet包"javax.servlet.“更改成了"jakarta.servle",有没有在不降低tomcat版本的情况下解决？

Answer 1

下午好🌅🌅🌅
本答案参考通义千问

在将 Tomcat 11 升级后，你遇到的 java.lang.NoClassDefFoundError: javax/servlet/ServletContextListener 错误，是由于 Servlet API 的包名发生了变化。这是 Tomcat 11 的一个重大变更，它不再支持 javax.servlet 包，而是改用 jakarta.servlet 包。

---

✅ 问题原因

• Tomcat 11 使用的是 Jakarta EE 9+ 标准。
• 在 Jakarta EE 9 中，所有 Servlet API 的类从 javax.servlet 改为 jakarta.servlet。
• 如果你的项目仍然依赖于 javax.servlet（如旧版的 Spring、Servlet、JSP 等），就会出现 NoClassDefFoundError。

---

✅ 解决方案：不降级 Tomcat 版本的前提下解决此问题

🔧 解决方案一：更新依赖库以使用 jakarta.servlet

你需要将项目中所有依赖的 Servlet API 相关库（如 servlet-api.jar）替换为 jakarta.servlet-api 的版本。

✅ 步骤如下：

1. 检查当前使用的依赖库

   • 检查 pom.xml（如果是 Maven 项目）或 build.gradle（Gradle 项目）中是否引入了 javax.servlet-api。

2. 替换为 jakarta.servlet-api

   • 对于 Maven：

     <dependency>
         <groupId>jakarta.servlet</groupId>
         <artifactId>jakarta.servlet-api</artifactId>
         <version>6.0.0</version> <!-- 根据你的 Tomcat 11 版本选择合适的版本 -->
         <scope>provided</scope>
     </dependency>
     

   • 对于 Gradle：

     implementation 'jakarta.servlet:jakarta.servlet-api:6.0.0'
     

3. 清理并重新构建项目

   mvn clean install
   

   或

   gradle clean build
   

4. 重启 Tomcat 11 并验证

---

🔧 解决方案二：使用兼容性库（适用于遗留代码）

如果你暂时无法修改代码，可以考虑使用 Jakarta EE 的兼容性库，例如：

• jakarta.servlet-api 和 javax.servlet-api 的兼容性桥接库（如 javax-servlet-api 到 jakarta-servlet-api 的适配器）。

但注意：这不是官方推荐的方式，且可能不稳定。

---

🔧 解决方案三：检查并修改代码中的 javax.servlet 引用

如果你的代码中有直接引用 javax.servlet.* 的类（如 javax.servlet.ServletContextListener），需要将其改为 jakarta.servlet.*。

✅ 示例代码修改：

原代码：

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

修改后：

import jakarta.servlet.ServletContextEvent;
import jakarta.servlet.ServletContextListener;

---

📌 总结

| 问题 | 解决方案 | |------|----------| | NoClassDefFoundError: javax/servlet/ServletContextListener | 将项目中所有 javax.servlet 的依赖和代码改为 jakarta.servlet | | 无法升级依赖 | 使用兼容性库（非推荐） | | 项目依赖旧版框架 | 更新框架到支持 Jakarta EE 的版本（如 Spring Boot 3+） |

---

🛠️ 最终建议

强烈建议：将项目中的所有 javax.servlet 替换为 jakarta.servlet，并确保所有依赖库也使用 jakarta.servlet-api，这样可以完全兼容 Tomcat 11。

---

✅ 示例：修改后的 pom.xml（Maven）

<dependencies>
    <!-- Jakarta Servlet API -->
    <dependency>
        <groupId>jakarta.servlet</groupId>
        <artifactId>jakarta.servlet-api</artifactId>
        <version>6.0.0</version>
        <scope>provided</scope>
    </dependency>

    <!-- 其他依赖... -->
</dependencies>

---

如有更多关于代码迁移的问题，欢迎继续提问！