已解决org.springframework.web.HttpMediaTypeNotAcceptableException异常的正确解决方法，亲测有效！！！

文章目录

问题分析

报错原因

解决思路

解决方法

总结

问题分析

在Spring MVC应用中处理HTTP请求时，我们有时会遇到org.springframework.web.HttpMediaTypeNotAcceptableException。这个异常通常发生在客户端请求指定的Accept头信息没有包含任何服务器可以生成的响应类型，或者Controller层无法提供客户端所能接受的媒体类型的数据。

报错原因

该异常可能是由以下几个原因导致的：

1. 客户端的Accept头不正确：客户端在发送请求时，Accept头参数错误或过于限制性。
2. 服务端缺少相应的消息转换器：服务器未配置能够产生客户端所接受媒体类型的消息转换器。
3. Controller方法不支持Accept头要求的返回类型：例如，一个REST API仅返回JSON，但客户端请求了XML格式。

解决思路

解决这个问题需要确保Spring MVC能够为客户端请求提供适当的响应格式。具体步骤包括：

1. 客户端调整：更新或修正客户端请求的Accept头信息，使之符合服务器能提供的媒体类型。
2. 服务端配置：在服务端添加或修改消息转换器，以支持更多的响应类型。
3. 编码实践：开发时需注意Controller的返回类型与客户端可接受的类型保持一致性。

解决方法

针对上述思路，下面是解决HttpMediaTypeNotAcceptableException异常的详细步骤：

• 客户端请求检查：首先，检查造成问题的HTTP请求，特别是Accept头部分。比如，在使用curl进行请求时，需要检查-H "Accept: application/json"等类似的部分是否符合预期。

• 配置消息转换器：如果确定客户端的Accept头没有问题，则需要在Spring MVC配置中添加或确认消息转换器。你可以通过实现WebMvcConfigurer接口并重写configureMessageConverters方法来添加或扩展消息转换器。

  @Configuration
  public class WebConfig implements WebMvcConfigurer {
    
      @Override
      public void extendMessageConverters(List> converters) {
          // 示例：添加对JSON的支持
          converters.add(new MappingJackson2HttpMessageConverter());
      }
  }
  

• Controller方法检查：确认Controller方法能够支持客户端请求的Accept类型。如果你的方法被标注了特定的返回类型如@GetMapping(produces = MediaType.APPLICATION_JSON_VALUE)，那么它只会返回JSON。确保这与客户端的Accept头相匹配。

• 后备消息转换器：在某些情况下，你可能需要配置一个后备消息转换器，允许你的API至少返回一种默认的媒体类型，即使它不是客户端明确请求的类型。

  @Bean
  public HttpMessageConverter