java.lang.NoClassDefFoundError: jakarta/servlet/Filter

### 关于 `java.lang.NoClassDefFoundError` 和 Jakarta Servlet 的解决方案 当 Java 应用程序运行时抛出 `java.lang.NoClassDefFoundError` 错误，通常是因为某个类在编译时可用但在运行时不可用。对于涉及 `jakarta.servlet.Filter` 的情况，这可能意味着应用程序依赖的库版本不匹配或缺少必要的 JAR 文件。 以下是针对该问题的具体分析和解决方法： #### 1. **确认使用的 Servlet API 版本** Jakarta EE 是 Oracle 将其捐赠给 Eclipse 基金会后的重命名项目。自 Servlet 5.0 开始，包名从 `javax.servlet.*` 更改为 `jakarta.servlet.*`[^2]。如果应用仍然使用旧版的 `javax.servlet.*` 而部署环境已切换到新的 `jakarta.servlet.*`，就会引发此类错误。 #### 2. **检查项目的构建工具配置** 如果是 Maven 或 Gradle 构建的应用程序，则需要确保引入了正确的依赖项。例如，在 Maven 中可以这样声明 Jakarta Servlet API 的依赖关系： ```xml <dependency> <groupId>jakarta.servlet</groupId> <artifactId>jakarta.servlet-api</artifactId> <version>6.0.0</version> <!-- 根据实际需求调整 --> <scope>provided</scope> </dependency> ``` 而在 Gradle 中对应的配置如下所示： ```gradle implementation 'jakarta.servlet:jakarta.servlet-api:6.0.0' ``` 上述代码片段中的版本号应根据目标服务器支持的情况来设定[^3]。 #### 3. **验证 Web 容器兼容性** 不同的容器（如 Tomcat, Jetty 等）对 Jakarta Servlet 的支持程度不同。Tomcat 9 支持的是 Servlet 4.0 (`javax.servlet`)，而 Tomcat 10 及以上则迁移到了 Jakarta Servlet (`jakarta.servlet`)。因此，若开发基于 Jakarta Servlet 的应用却试图将其部署至仅支持传统 javax 包名的老版本容器上，也会触发此异常[^4]。 #### 4. **清理并重新打包项目** 有时本地缓存可能导致某些文件未被正确更新。执行以下命令可以帮助清除潜在的问题源： - 对于 Maven 用户： ```bash mvn clean install ``` - 针对 Gradle 使用者而言则是： ```bash gradle clean build ``` 完成这些操作后再尝试启动服务以观察效果变化如何。 #### 5. **排查其他间接依赖冲突** 除了直接指定的 servlet api 外部 jar 包外，还需留意是否有第三方框架也嵌入了自己的 servlet 实现或者桥接组件。通过查看完整的 stack trace 来定位具体缺失哪个 class 并进一步调查是否存在多重定义情形下的优先级覆盖现象等问题所在之处加以修正即可解决问题[^5]。 --- ### 提供一段简单的过滤器实现样例作为参考 下面展示了一个基本的 `Filter` 类型实例用于演示目的： ```java import jakarta.servlet.*; import java.io.IOException; public class ExampleFilter implements Filter { @Override public void init(FilterConfig filterConfig) throws ServletException {} @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { System.out.println("Before processing..."); chain.doFilter(request, response); System.out.println("After processing..."); } @Override public void destroy() {} } ``` 注意这里导入的是 `jakarta.servlet.*` 下的相关接口而非之前的 `javax.servlet.*`. ---