Spring Boot入门编译报错：无法找到RestController等符号求助

排查步骤 #

• 检查pom.xml核心依赖配置
  确保pom.xml中已正确引入spring-boot-starter-parent父依赖和spring-boot-starter-web依赖，这两个是包含SpringBootApplication、RestController、RequestMapping等核心类的基础：

  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>对应教程使用的Spring Boot版本</version>
      <relativePath/>
  </parent>
  
  <dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
  </dependencies>
  

  版本号必须和教程保持一致，避免版本不兼容导致依赖缺失。

• 强制刷新Maven依赖
  本地仓库的依赖可能存在损坏或未完全下载的情况，执行以下命令清理并重新拉取所有依赖：

  mvn clean install -U
  

  -U参数会强制Maven更新远程仓库的依赖快照和正式版本。

• 验证IDE的Maven同步状态（使用IDE开发时）
  如果用IntelliJ IDEA或Eclipse开发，需确保IDE已正确同步Maven配置：

  • IDEA：右键项目 → Maven → Reload Project
  • Eclipse：右键项目 → Maven → Update Project，勾选"Force Update of Snapshots/Releases"

• 检查代码导入语句
  即使代码复制自教程，也需确认类顶部的导入路径是否正确，避免导入错误包：

  import org.springframework.boot.SpringApplication;
  import org.springframework.boot.autoconfigure.SpringBootApplication;
  import org.springframework.web.bind.annotation.RestController;
  import org.springframework.web.bind.annotation.RequestMapping;
  

• 确认Java版本兼容性
  Spring Boot不同版本对Java版本有明确要求，比如Spring Boot 3.x需要Java 17及以上，2.7.x支持Java 8-17。执行java -version查看当前Java版本，确保和教程使用的Spring Boot版本匹配。

额外验证 #

若以上步骤无效，执行mvn dependency:tree查看依赖树输出，确认spring-boot-starter-web、spring-web、spring-boot-autoconfigure这些核心依赖是否存在。如果缺失，需检查Maven的settings.xml配置，确保镜像仓库可正常访问。

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