SpringBoot启动报错：解决NoClassDefFoundError:jakarta/servlet/http/HttpSessionContext

Spring Boot项目启动时报错`java.lang.NoClassDefFoundError: jakarta/servlet/http/HttpSessionContext`？本文详解该错误的根本原因：缺少Jakarta Servlet API依赖。由于Spring Boot 2.x及以上版本已迁移至Jakarta Servlet API，旧项目需添加`jakarta.servlet-api`依赖到`pom.xml`或`build.gradle`中，并设置`provided`作用域。文章提供详细解决步骤，包括依赖添加方法及排查依赖冲突和版本兼容性问题的建议，助您快速解决Spring Boot启动失败问题。

Spring Boot项目启动失败：深入解析java.lang.NoClassDefFoundError: jakarta/servlet/http/HttpSessionContext

Spring Boot应用启动时，各种错误层出不穷。本文分析一个常见的启动失败案例，错误信息如下：

Caused by: java.lang.NoClassDefFoundError: jakarta/servlet/http/HttpSessionContext
at org.eclipse.jetty.servlet.ServletContextHandler.newSessionHandler(ServletContextHandler.java:339)
at org.eclipse.jetty.servlet.ServletContextHandler.getSessionHandler(ServletContextHandler.java:432)
at org.eclipse.jetty.servlet.ServletContextHandler.relinkHandlers(ServletContextHandler.java:257)
at org.eclipse.jetty.servlet.ServletContextHandler.(ServletContextHandler.java:180)
at org.eclipse.jetty.webapp.WebAppContext.(WebAppContext.java:301)
at org.eclipse.jetty.webapp.WebAppContext.(WebAppContext.java:228)
at org.springframework.boot.web.embedded.jetty.JettyEmbeddedWebAppContext.(JettyEmbeddedWebAppContext.java:28)
at org.springframework.boot.web.embedded.jetty.JettyServletWebServerFactory.getWebServer(JettyServletWebServerFactory.java:159)
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.createWebServer(ServletWebServerApplicationContext.java:183)
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.onRefresh(ServletWebServerApplicationContext.java:161)
... 13 common frames omitted

该错误提示找不到jakarta/servlet/http/HttpSessionContext类，通常是因为缺少Servlet API依赖。HttpSessionContext属于Jakarta Servlet API，而较旧项目可能使用javax.servlet.http.HttpSessionContext。Spring Boot 2.x及以上版本已迁移至Jakarta Servlet API，因此需确保项目包含正确的Jakarta Servlet API依赖。

解决方法：检查pom.xml(Maven项目)或build.gradle(Gradle项目)，确认是否包含正确的Jakarta Servlet依赖。若缺少，需添加，例如(版本号需根据实际情况调整)：

jakarta.servletjakarta.servlet-apiYOUR_VERSION_HEREprovided

provided表示该依赖在运行时由容器提供，无需包含在最终应用包中。如果应用服务器未提供此依赖，则需将scope改为compile。添加依赖后，重新构建并运行项目。如果问题依然存在，检查是否存在依赖冲突或版本不兼容问题。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~