26 记一次 SpringMVC 406 The resource identified by this request is only capable of generating responses

本文主要是介绍26 记一次 SpringMVC 406 The resource identified by this request is only capable of generating responses，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

问题如下图所示

/common/test406.html, 此接口访问的是 SpringMVC 的一个 Controller 的一个接口, 该接口上面有 @ResponseBody, 意图为作为一个提供数据的数据接口

当天晚上[10月18日晚]跟了一下代码, 差不多是临时解决了一下问题, 思路在后面

当天晚上是花了很多时间的, 突然发现了自己对于 SpringMVC 这个框架的认识还太浅, 虽然以前也看过脉络的代码, 但是久而久之就忘记了, 然后今天重新更了一下大体流程的代码

这里总结下, 之前的一个问题, 我注册了一个 mvcContentNegotiationManager, 然后之后就解决了之前的一个 .html 访问某一@ResponseBody 接口响应406的问题,
<mvc:annotation-driven />, 这里的的 AnnotationDrivenBeanDefinitionParser, 想 ac 中注入了一个

RootBeanDefinition factoryBeanDef = new RootBeanDefinition(ContentNegotiationManagerFactoryBean.class);
factoryBeanDef.setSource(source);
factoryBeanDef.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
factoryBeanDef.getPropertyValues().add("mediaTypes", getDefaultMediaTypes());

创建的是一个 ContentNegotiationManagerFactoryBean, 然后之后的时候, 触发了 afterPropertiesSet 初始化, 然后想contentNegotiationManager[前者] 中增加了 ServletPathExtensionContentNegotiationStrategy, 然后之后是默认的 HeaderContentNegotiationStrategy
我自己定义的 id为 mvcContentNegotiationManager[后者], 直接使用类的初始化方法进行初始化, 里面默认有一个 HeaderContentNegotiationStrategy

然后在这里访问接口的时候, 前者拦截了 .html 然后查询请求需要的类型, ServletPathExtensionContentNegotiationStrategy 在HeaderContentNegotiationStrategy之前, 然后拿到请求的需要的类型为 text/html, 然后响应这边给出的 Content-Type 为 application/json;charset=UTF-8, application/*+json;charset=UTF-8
然后请求和响应的MimeType 不兼容, 然后走了后面的 "throw new HttpMediaTypeNotAcceptableException"

然后后者, 通过 HeaderContentNegotiationStrategy, 在 header 获取客户端接收的类型, 其中有一个; */*吧, 支持所有类型, 这个兼容响应的类型, 然后就通过了

ContentNegotiationManager. resolveMediaTypes

public List<MediaType> resolveMediaTypes(NativeWebRequest request)throws HttpMediaTypeNotAcceptableException {for (ContentNegotiationStrategy strategy : this.strategies) {List<MediaType> mediaTypes = strategy.resolveMediaTypes(request);if (mediaTypes.isEmpty() || mediaTypes.equals(MEDIA_TYPE_ALL)) {continue;}return mediaTypes;}return Collections.emptyList();
}

if (compatibleMediaTypes.isEmpty()) {if (returnValue != null) {throw new HttpMediaTypeNotAcceptableException(producibleMediaTypes);}return;
}

然后这里还有一个需要注意的问题, 容器的初始化流程,
<mvc:annotation-driven />
<bean id="mvcContentNegotiationManager" class="org.springframework.web.accept.ContentNegotiationManager"/>
这样的顺序是没有问题的, 因为后来的 beanDef 覆盖了前面的 AnnotationDrivenBeanDefinitionParser 中向 ac 中注册的beanDef,
但是反过来, 执行的最终容器中保留的就是, ContentNegotiationManagerFactoryBean 计算得到的 contentNegotiationManager, 然后因此, 之前的 406 会出现

此问题, 另外一种解决思路是, 去掉请求时候的后缀, 或者更换后缀, 此ServletPathExtensionContentNegotiationStrategy 默认支持的后缀来自于, 其依赖的 ContentNegotiationManager 为["xml" -> "application/xml", "json" -> "application/json"] 以及handleNoMatch的时候支持的 FileTypeMap. getDefaultFileTypeMap,
默认的 ContentNegotiationManager初始化部分具体的代码请参见 : AnnotationDrivenBeanDefinitionParser. getContentNegotiationManager

http://www.codeweblog.com/%E8%A7%A3%E5%86%B3springmvc%E4%B8%AD%E7%9A%84-could-not-find-acceptable-represent/

此问题, 还有一个奇葩的插曲, 我按照上面的链接的方式修改了之后, 我这边没有问题了, 然后同事那边更新了之后, 缺访问不了静态资源了, 然后我clean了一下浏览器的缓存, 然后刷新发现依然能够拿到静态资源
这里不能拿到静态资源也不难理解, 相关的请求被 dispatcherServlet, 拦截了, 然后被internalResourceViewResolver拦截了, 然后在/WEB-INF/pages 下面找资源, 然而真正的资源在外层的 webapps/$CONTEXT_PATH/static
然后 dispatcherServlet 拦截的 url-pattern 为 *.html 的时候, 静态资源相关请求是被 Tomcat 的 DefaultServlet 来处理
然后之后的时候, 同事更新了一下代码, 增加了 MappingJackson2HttpMessageConverter 的配置, 然后加入了一些依赖之后, 就能够通过 .html 访问道接口, 拿到正确的数据了,

详细的细节, 以及追一下, 如下图的代码,

--------------------------------------------------------------------------------

最后的时候, 说一下, 构造此种情况的方法
1. web.xml 中的配置

	<servlet><servlet-name>springDispatcherServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring/applicationContext-mvc.xml</param-value></init-param><load-on-startup>2</load-on-startup></servlet><servlet-mapping><servlet-name>springDispatcherServlet</servlet-name><url-pattern>*.html</url-pattern></servlet-mapping>

2. applicationContext-mvc.xml 中添加 <mvc:annotation-driven />
3. 增加 @Controller

    @RequestMapping(value = "test406")@ResponseBodypublic JSONObject test406(HttpServletRequest request, HttpServletResponse response) throws Exception {JSONObject result = new JSONObject();result.put("k", "v");return result;}

======================= add at 2018.11.28 =======================

上周四的时候, 我们同事同样是碰到了一个这样的 406 的问题, 然后我就感觉之前遇到过

然后之后今天的时候, 看了一下, 跟了一下流程

示例代码如下

直接发送http请求, 我们期望拿到的是一个正确的 json 结果, 但是实际上返回的是一个 406 的错误页面

然后假设吧 "doc.list" 更新为 "doc.list1", 然后就能够拿到期望的正确页面, 那么这个是怎么回事呢??

我们这里的 mvcContentNegotiationManager 属于上面的前者, 使用的是 AnnotationDrivenBeanDefinitionParser 处理的过程中注入的 mvcContentNegotiationManager, 优先使用 ServletPathExtensionContentNegotiationStrategy 解析客户端请求的 mimeType, 然后再尝试使用 HeaderContentNegotiationStrategy 来解析客户端请求的 mimeType

使用"doc.list", 调试发现, 使用 ServletPathExtensionContentNegotiationStrategy 首先 lookupMediaType 没有找到 "list" 对应的 mimeType, 然后在 handleNoMatch 的补偿中在 ServletContext -> StandardContext 中找到了 list 对应的 mimeType 为 "text/plain", 然后就返回回去了

然后实际响应的类型是 "application/json" 和 "application/*+json", 请求类型和响应类型不兼容走了后面的 "throw new HttpMediaTypeNotAcceptableException"

使用"doc.list1", 调试发现, 两个 NegotiationStrategy 都没有从请求中找到合适的类型, 然后使用了默认的 "*/*", 接受所有的类型

AbstractMappingContentNegotiationStrategy. resolveMediaTypeKey

public List<MediaType> resolveMediaTypeKey(NativeWebRequest webRequest, String key)throws HttpMediaTypeNotAcceptableException {if (StringUtils.hasText(key)) {MediaType mediaType = lookupMediaType(key);if (mediaType != null) {handleMatch(key, mediaType);return Collections.singletonList(mediaType);}mediaType = handleNoMatch(webRequest, key);        // line : 78if (mediaType != null) {addMapping(key, mediaType);return Collections.singletonList(mediaType);}}return Collections.emptyList();
}