Spring MVC 以.html为后缀名访问获取数据，报406 Not Acceptable错误。

怼烎@ 2022-05-21 05:46 164阅读 0赞

# 如题，最近以spring mvc作为后台框架，前端异步获取数据时（.html为后缀名的访问方式），报406 Not Acceptable错误。当初都不知道啥原因，前后台都没报错就是返回不了数据，于是查了下http 406响应码：406 (SC\_NOT\_ACCEPTABLE)表示请求资源的MIME类型与客户端中Accept头信息中指定的类型不一致。下面请看出错的操作流程及代码： #

1、先配置spring mvc 核心servlet （DispatcherServlet） 至web.xml中，其中配置可以以.html和.do为后缀名的请求。（注意：只显示重要代码，下面也是一样）

![复制代码][copycode.gif]

<servlet>
            <servlet-name>DispatcherServlet</servlet-name>
            <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
            <init-param>
                <param-name>contextConfigLocation</param-name>
                <param-value>classpath:dispatcher-servlet.xml</param-value>
            </init-param>
        </servlet>
        <servlet-mapping>
            <servlet-name>DispatcherServlet</servlet-name>
            <url-pattern>*.html</url-pattern>
        </servlet-mapping>
        <servlet-mapping>
            <servlet-name>DispatcherServlet</servlet-name>
            <url-pattern>*.do</url-pattern>
        </servlet-mapping>

![复制代码][copycode.gif]

2、controller部分代码如下：

![复制代码][copycode.gif]

@RequestMapping(value="chat/startClient")
        @ResponseBody public AjaxResult startClient(UserEntity user,HttpServletRequest request) {
            AjaxResult result = new AjaxResult(1);
            if (user.getUserId() == null){
                user.setUserId(System.currentTimeMillis());
                SessionUtil.setAttr(request, SessionUtil.SESSION_USER, user);
            } else {
                UserEntity sessionUser = SessionUtil.getUser(request);
                if (sessionUser.getUserId().equals(user.getUserId())) {
                   user = sessionUser; 
                }
            }
            if (Client.startClient(user)) {
                result.setData(user);
            }
            return result;
        }

![复制代码][copycode.gif]

3、jsp 异步请求代码如下：

![复制代码][copycode.gif]

$.ajax({
    　　　　url:'${pageContext.request.contextPath}/chat/startClient.html',
           dataType: 'json',
           data:{userId:$("input[name=userId]").val(),userName:$("#userName").val()},
    　　　　success: function(result){
           　　var state = result.error;
              if(state == 1){
       　　　　　　$('.modal-header .close').click();
    　　　　　　　　$("input[name=userName]").val($("#userName").val());
    　　　　　　}
    　　　　}
    　　});

![复制代码][copycode.gif]

配置以上代码启动项目访问上面jsp中的异步方法时，通过浏览器的开发者工具（google）查看请求结果如下，通过响应头来看Content-type确实不一样，返回的是text/html，而请求的是application/json,所以浏览器无法解析或者接受这样的类型，就报错406错误。

![690169-20170722140111902-1053068303.png][]

针对上面情况在网上折腾了一会，终于找到了破解之法，该问题的主要原因：Spring MVC有点不一样，如果你没有配置什么样的请求方式对应什么样的响应方式的话，它会根据url的后缀名对应不同响应头的格式，如下：

![复制代码][copycode.gif]

public class MediaType extends MimeType
      implements Serializable
    {
      private static final long serialVersionUID = 2069937152339670231L;
      public static final MediaType ALL = valueOf("*/*");
      public static final String ALL_VALUE = "*/*";
      public static final MediaType APPLICATION_ATOM_XML = valueOf("application/atom+xml");
      public static final String APPLICATION_ATOM_XML_VALUE = "application/atom+xml";
      public static final MediaType APPLICATION_FORM_URLENCODED = valueOf("application/x-www-form-urlencoded");
      public static final String APPLICATION_FORM_URLENCODED_VALUE = "application/x-www-form-urlencoded";
      public static final MediaType APPLICATION_JSON = valueOf("application/json");
      public static final String APPLICATION_JSON_VALUE = "application/json";
      public static final MediaType APPLICATION_OCTET_STREAM = valueOf("application/octet-stream");
      public static final String APPLICATION_OCTET_STREAM_VALUE = "application/octet-stream";
      public static final MediaType APPLICATION_XHTML_XML = valueOf("application/xhtml+xml");
      public static final String APPLICATION_XHTML_XML_VALUE = "application/xhtml+xml";
      public static final MediaType APPLICATION_XML = valueOf("application/xml");
      public static final String APPLICATION_XML_VALUE = "application/xml";
      public static final MediaType IMAGE_GIF = valueOf("image/gif");
      public static final String IMAGE_GIF_VALUE = "image/gif";
      public static final MediaType IMAGE_JPEG = valueOf("image/jpeg");
      public static final String IMAGE_JPEG_VALUE = "image/jpeg";
      public static final MediaType IMAGE_PNG = valueOf("image/png");
      public static final String IMAGE_PNG_VALUE = "image/png";
      public static final MediaType MULTIPART_FORM_DATA = valueOf("multipart/form-data");
      public static final String MULTIPART_FORM_DATA_VALUE = "multipart/form-data";
      public static final MediaType TEXT_HTML = valueOf("text/html");
      public static final String TEXT_HTML_VALUE = "text/html";
      public static final MediaType TEXT_PLAIN = valueOf("text/plain");
      public static final String TEXT_PLAIN_VALUE = "text/plain";
      public static final MediaType TEXT_XML = valueOf("text/xml");
      public static final String TEXT_XML_VALUE = "text/xml";
      private static final String PARAM_QUALITY_FACTOR = "q";
    }

![复制代码][copycode.gif]

解决方法：所以我们要针对此情况进行配置，更改html对应返回的类型。（注意：1、先声明下我使用的spring 版本：4.1.9，2、如果想要使用@ResponseBody返回json格式，就需要加载这三个包:jackson-core、jackson-databind和jackson-annotations，请自行去mvn repository中获取） 一般我们是配置在mvc配置文件中需要配置<mvc:annotation-driven />, 所以我们只要修改下这里就行，修改配置代码如下：

![复制代码][copycode.gif]

<mvc:annotation-driven content-negotiation-manager="contentNegotiationManager" />
        
        <bean id="contentNegotiationManager" class="org.springframework.web.accept.ContentNegotiationManagerFactoryBean"> 
            <property name="mediaTypes">  
                <map>  
                    <entry key="html" value="application/json;charset=UTF-8"/> 
                </map>  
            </property> 
        </bean>

![复制代码][copycode.gif]

ContentNegotiationManagerFactoryBean 是内容协商管理工厂bean对象，主要用来配置多视图请求格式。

其中有人问我说，为什么要用.html作为后缀名访问，如果不用它的话也不会有这样的错误出现，多省事。 其实我我觉的用.html作为后缀名访问的话,使得url形成了一种伪路径，相对来说增强了安全性。

补:也可以单独修改请求url,在配置web.xml中增加servlet的映射路径

[copycode.gif]: /images/20220521/84e0c786ae164f4b93e564dab67f6f7e.png
[690169-20170722140111902-1053068303.png]: /images/20220521/5ae001b01e2b4e4e99204b08d03e83d2.png