（转载）常见踩坑案例(二)-Request method 'POST' not supported

原文地址

一 前言

最近涉及到与前后端的数据对接，按道理来说没一点压力结果被一前端童鞋带坑里去了（不过也是很久没写过这种前后端分离进行联调的事情了，如果是一个人全套弄的话就不会出现下面问题）。

二 Request method 'POST' not supported

进入正文，跟前端进行数据联调时，别人联调都正常，到联调我的接口（进行数据获取）就出现了问题。

下面进行异常场景还原（后端环境：Spring MVC4.0.5）：

1、前端访问我这边的接口抛出错误码：****405 Method not allowed 。当时就感觉奇怪，我自己用postman都能调通啊，为什么你那边不能允许访问呢。看到这个错误码，于是我就抛出两个问题给他：

• 你是用post请求吗？
• **你请求的content-type是application/json吗？ **

然后他毫不犹豫的说都是。
　　2、于是我看下后端请求的日志，SpringMVC日志提示：“[org.springframework.web.servlet.PageNotFound] >>> Request method 'POST' not supported” 。

提示这个错误，我就纳闷了。条件反射让我想起是不是在@RequestMapping中Method 没有指定为post？ 其实我指定了post方法的，这个肯定排除了。

@RequestMapping(value = "/home/test", method = RequestMethod.POST)
    @ResponseBody
    public Object test(@RequestBody UserEntity userEntity) {

        return "1234";
    }

难道真的是我后端的问题？查了网上很多问题一堆不靠谱：(，一直沉迷于Request method 'POST' not supported这个信息无法自拔，难道这配置不支持post方法？。于是就尝试了以下手段：

a、ResourceHttpRequestHandler在springMVC配置文件配置强制支持post方法。可想而知，ResourceHttpRequestHandler针对静态资源的获取及其缓存设置。很明显不符合场景，试了也是白试。如果你这种场景请参考这里获取对你有帮助：https://stackoverflow.com/questions/15588001/spring-not-accept-post-request-under-mvcresources-how-to-fix-that。

b、尝试将RequestMapping中请求的方法改成get，前端也用get请求，并没有用。

3、尝试了上面方法后无果，有位前辈说不妨你跟踪下SpringMVC中日志代码。

第一步：查看PageNotFound是否存在对应的类（这一步其实一出现我就查看是没有的），怎么验证它是否存在呢？很简单：在代码中输入它看是否有对应的引用包。

  ![image](https://upload-images.jianshu.io/upload_images/7710943-0d2bb1a31555e7e9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

第二步：第一步最直接的入口失败，于是想到了SpringMVC的核心Servlet：DispatcherServlet， 而它的核心方法则是：doDispatch，于是在方法中进行断点调试找到出错原因。经过调试后，终于发现问题所在，发现在解析json是实体的属性出错，如下图：

image

上述案例是说不能解析namqe这个属性，而我UserEntity对象中的属性是name,所以解析类就抛出异常（至于在哪一步解析出错，这就不一一说了）。

　　经过上面一步一步的探索终于找到问题的所在：原来是前端童鞋传json的时候，把参数名称弄错了。

　　4、拓展

虽然问题解决了，但是为啥Spring MVC 为啥抛出那样的日志，而不是具体的错误信息呢？如果是具体的错误信息那不简单明了嘛，也不至于花了这么时间去定位问题所在。于是继续调试看看这个错误信息为什么被转换了？看上面图的971行，最终结果都会进入到这个方法processDispatchResult，而它的第一步就是检测是否有异常，如果有异常则先处理异常：

image

里面流程也不一一显示了，直接跳到具体解析异常的类：DefaultHandlerExceptionResolver，我们看看这个类中有什么又是怎么处理异常的。
　　

image

看到上图就应该想到之前提示的日志为什么有[org.springframework.web.servlet.PageNotFound]，而找不到对应的类了吧，因为它只是一个日志的Event_Name。

　　继续跟踪：最终它是走入了HttpMessageNotReadableException类，表示读取信息错误。

image

继续进入handleHttpMessageNotReadable方法，看到这里就知道结果了，它把原来的错误信息给修改并返回了。

image

另外这里不是真的返回信息，上面错误信息返回之后还会再次进入DispatcherServlet类重新又走了一遍，所以错误信息又重新判断一次最终进入了下面这个方法，真正的输入日志的地方在这：

image

所以这个是Spring MVC 4.0.5.RELEASE版本的问题，升级到4.2.0以上就不会抛出这个问题，它会识别能识别的参数继续运行，不会抛出错误。

三 总结

针对这种405错误，总结一下几点：

1、首先第一个需要确认请求方法类型是否一致？

2、请求数据类型 和 接收的数据类型是否一致？

3、请求参数是否正确？

以上都正确的话，然后在具体问题具体分析，一步一步跟踪才是最有效的。