Spring Boot应用请求Angular/HTML/JSP资源时出现405方法不支持异常

这种405的坑我在Spring Boot项目里踩过好几次，咱们从几个关键方向入手调试，再梳理可能的原因：

先从调试步骤开始 #

• 抓包看真实请求：打开浏览器F12的Network标签，访问出现问题的页面，看请求的Method到底是GET还是POST？有时候可能是页面里的表单默认提交方式写错，或者Angular路由配置里不小心用了POST请求加载模板——这时候GET访问页面的请求其实被改成了POST，自然和后端的配置不匹配。
• 看Spring Boot的映射日志：把日志级别调到DEBUG（在application.properties里加logging.level.org.springframework.web=DEBUG），重启后看请求进来时的日志。Spring会详细输出它在找哪个路径的Handler，为什么匹配失败，比如会看到类似Looking up handler method for path /home，然后提示No matching handler method found或者Found handler method but supports only POST，这直接就能定位到冲突点。
• 检查静态资源/视图的访问逻辑：如果是纯HTML/JSP，先直接访问静态资源路径（比如http://localhost:8080/index.html），看是否正常。如果正常，说明是路由或者Controller的问题；如果还是405，那要检查静态资源的配置有没有被修改，比如自定义的WebMvcConfigurer是不是限制了静态资源的请求方法。

可能的核心原因 #

• 路径冲突：这是最常见的！比如你有个@PostMapping("/user")的API接口，同时你的Angular路由或者静态页面也用了/user路径。当浏览器GET访问/user时，Spring优先匹配到了POST的API控制器，自然返回405——因为这个路径只接受POST请求。
• Controller注解限制过严：比如某个Controller的方法用了@RequestMapping(value = "/", method = RequestMethod.POST)，把根路径的请求限制成了POST，那访问首页的GET请求就会直接触发405。
• 视图解析器配置错误：如果用了Thymeleaf/JSP，视图解析器的前缀后缀配置不对，导致Spring找不到对应的视图文件，转而尝试匹配API接口，结果匹配到了一个只支持POST的接口，返回405。
• 拦截器/过滤器干扰：比如Spring Security的配置，有没有强制某些路径必须用POST？或者自定义的过滤器修改了请求方法？比如CSRF配置异常也可能间接导致这类问题（不过一般是403，但特殊场景下也会有405）。
• AngularJS路由错误：比如$routeProvider配置的路径和后端API路径重叠，或者在加载模板时误用了$http.post而不是$http.get，导致请求方法不匹配。

快速修复建议 #

• 给API加统一前缀：比如所有API都放在/api/下，页面/路由放在根路径，从根源避免路径冲突。
• 检查所有Controller的请求方法注解：确保页面访问的路径没有被@PostMapping或仅允许POST的@RequestMapping占用。
• 先简化场景：暂时禁用Angular路由，直接访问静态HTML，看是否正常，逐步排查是前端路由还是后端配置的问题。

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