Spring Boot项目配置类解析失败，javax.servlet.ServletContext缺失

以下是针对该问题的排查和解决步骤：

• 检查Web Starter依赖是否存在
  确认你的构建文件（Maven的pom.xml或Gradle的build.gradle）中是否正确引入了spring-boot-starter-web。这个依赖会自动包含Servlet API相关包，是Web类型Spring Boot项目的核心依赖：
  Maven配置示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  

  Gradle配置示例：

  implementation 'org.springframework.boot:spring-boot-starter-web'
  

• 排查Servlet API依赖的范围问题
  如果手动添加过javax.servlet-api依赖，务必检查其scope设置。正确的scope应为provided——因为内嵌Tomcat或外部容器会在运行时提供该API，若设为compile会引发依赖冲突，导致类加载异常：
  错误配置示例（需修正）：

  <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
      <scope>compile</scope> <!-- 改为provided -->
  </dependency>
  

• 清理依赖缓存并重新构建
  执行构建工具的清理命令，清除本地仓库中可能损坏或不兼容的依赖文件：

  • Maven：mvn clean install -U
  • Gradle：./gradlew clean build --refresh-dependencies

• 修复IntelliJ项目配置

  1. 打开File > Project Structure，进入Modules选项卡，确认所有Spring Boot相关依赖已正常加载，无红色报错提示。
  2. 进入Build, Execution, Deployment > Build Tools下的Maven/Gradle配置页，确保使用本地正确的构建工具版本，并开启自动导入。
  3. 执行File > Invalidate Caches...，选择Invalidate and Restart，清除IntelliJ的缓存文件，避免缓存导致的依赖加载异常。

• 确认Spring Boot版本兼容性
  若你升级了IntelliJ，可能默认生成的Spring Boot版本为3.x，但3.x已将Servlet API从javax迁移到jakarta命名空间，旧项目基于javax的代码会直接出现类找不到的错误。此时需将Spring Boot版本换回2.x（对应JDK 8/11），保持与旧项目的依赖兼容。

内容的提问来源于stack exchange，提问作者GMarsh