Spring Boot认证API持续返回404错误排查求助

• 先确认基础运行状态

  • 查看控制台启动日志，确保应用无报错、完全启动（比如看到Started Application in X seconds的日志）。
  • 核对请求端口与应用启动端口一致：默认是8080，若修改过server.port配置，请求时必须用对应端口。
  • 验证接口路径正确性：控制器类必须标注@RestController/@Controller，方法上的@RequestMapping/@PostMapping等注解路径无拼写错误；若配置了server.servlet.context-path，请求路径必须加上这个上下文前缀。

• 排查IntelliJ IDEA配置问题

  • 清理IDE缓存：File → Invalidate Caches...，勾选Clear file system cache and local history后重启IDEA，避免旧缓存干扰。
  • 重新构建项目：执行Build → Rebuild Project，确保编译后的class文件是最新版本，无旧代码残留。
  • 检查运行配置：确认Run/Debug Configuration的Main Class是正确的主应用类，未选错其他类；若启用了Delegate IDE build/run actions to Maven/Gradle，尝试关闭后重启应用。
  • 校验项目结构：File → Project Structure，确认src/main/java被标记为Sources目录，src/main/resources标记为Resources目录，未被误设为Excluded。

• 排查Spring配置问题

  • 检查主应用类的@SpringBootApplication：如果控制器不在主应用类的同级或子包下，需添加@ComponentScan(basePackages = "xxx")指定扫描路径，否则Spring无法识别控制器Bean。
  • 检查自定义WebMvcConfigurer：若有重写addResourceHandlers或configurePathMatch方法，确认未修改路径匹配规则导致接口无法被路由。
  • 核对路径匹配策略配置：查看application.properties/yaml中的spring.mvc.pathmatch.matching-strategy，若使用ANT_PATH_MATCHER需符合Ant路径规则；若用PATH_PATTERN_PARSER，注意通配符写法差异。

• 排查Spring Security残留影响

  • 检查是否存在自定义Security配置类：比如继承WebSecurityConfigurerAdapter的类，即使主应用排除了SecurityAutoConfiguration，这些自定义类若未被禁用，仍可能干扰请求处理。
  • 核对依赖项：确认pom.xml/build.gradle中是否还残留Spring Security相关依赖，若有，即使排除自动配置，部分组件仍可能加载导致异常，可暂时移除测试。

• 极端环境验证

  • 用命令行启动项目：执行mvn spring-boot:run（Maven）或gradle bootRun（Gradle），若命令行启动后接口正常，说明问题出在IDEA配置。
  • 新建极简测试项目：只引入Spring Web依赖，编写一个简单的测试接口（比如@GetMapping("/test")返回字符串），若仍无法访问，需排查本地环境问题（比如JDK版本不兼容、端口被防火墙拦截）。

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