Spring Boot无法识别@RestController等注解，本地运行异常求助

1. Security配置未生效、自动生成默认密码 #

• 确保Security配置类同时添加@Configuration和@EnableWebSecurity（Spring Boot 3.x需搭配@EnableMethodSecurity），缺少任一注解Spring会启用默认安全配置，自动生成随机密码。
• 验证配置类包路径是否在启动类扫描范围内：若启动类包为com.xxx.project，配置类需在com.xxx.project或其子包下；若不在，需在启动类添加@ComponentScan(basePackages = "com.xxx.config")指定扫描路径。
• 核对pom.xml中Spring Security依赖版本与原项目一致，避免依赖冲突（比如同时引入了第三方安全框架），执行mvn dependency:tree查看依赖树，排查冲突项。

2. 登录后所有接口无法访问，仅显示/error端点 #

• 查看启动日志，搜索Mapped "关键词，确认业务控制器的接口是否被正确映射。若未找到映射记录，检查控制器是否添加@RestController/@Controller注解，且包路径在启动类扫描范围内。
• 检查Security配置的授权规则：确保登录接口（如/login）被设置为permitAll()，避免未登录时被拦截；同时确认JwtAuthenticationFilter已正确加入Security过滤链，示例配置：

  @Bean
  public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
      http.addFilterBefore(jwtAuthenticationFilter(), UsernamePasswordAuthenticationFilter.class);
      // 其他配置...
  }
  

• 核对application.properties中的server.servlet.context-path配置，若原项目配置了上下文路径（如/api），本地访问需加上该路径（如localhost:8080/api/xxx），否则会跳转至/error。
• 检查JWT密钥配置：确认application.properties中的jwt.secret与原项目完全一致，密钥不匹配会导致token解析失败，认证被拦截。

3. 本地环境专项排查 #

• 清理Maven缓存并重新构建：执行mvn clean install -U，强制拉取最新依赖包，避免本地依赖损坏或版本不匹配。
• 确认JDK版本一致：在IntelliJ的Project Structure中检查SDK和Language Level，确保与原项目使用的JDK版本（如JDK17）完全相同。
• 检查Spring Boot运行配置：在Run/Debug Configurations中确认Active Profiles与原项目一致，避免加载错误的配置文件。
• 清理IntelliJ缓存：执行File -> Invalidate Caches...并重启IDE，解决IDE缓存导致的类加载异常问题。

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