已解决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 {@Overridepublic void extendMessageConverters(List<HttpMessageConverter<?>> converters) {// 示例：添加对JSON的支持converters.add(new MappingJackson2HttpMessageConverter());}
  }
  

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

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

  @Bean
  public HttpMessageConverter<Object> fallbackConverter() {return new MappingJackson2HttpMessageConverter();
  }

• 测试验证：完成以上步骤后，重新启动Spring应用并使用工具（例如Postman）来测试API，验证问题是否已经解决。

总结

在处理org.springframework.web.HttpMediaTypeNotAcceptableException时，关键是理解HTTP请求和响应中的媒体类型协商机制。通过调整客户端的请求头、确保服务端配置了适当的消息转换器，并且Controller层能够提供各种媒体类型，可以有效地避免这一异常。紧密跟踪Spring框架的最佳实践，可以帮助开发人员构建出既灵活又健壮的Web服务。希望这篇文章能帮助你解决HttpMediaTypeNotAcceptableException异常，确保你的Web应用能够顺利处理各种复杂的HTTP请求。

 以上是此问题报错原因的解决方法，欢迎评论区留言讨论是否能解决，如果本文对你有帮助 欢迎 关注 、点赞 、收藏 、评论， 博主才有动力持续记录遇到的问题！！！

博主v：XiaoMing_Java

 📫作者简介：嗨，大家好，我是 小明java问道之路，互联网大厂后端研发专家，2022博客之星TOP3 / 博客专家 / CSDN后端内容合伙人、InfoQ(极客时间)签约作者、阿里云签约博主、全网5万粉丝博主。

---

🍅 文末获取联系 🍅  👇🏻 精彩专栏推荐订阅收藏 👇🏻

专栏系列（点击解锁）	学习路线（点击解锁）	知识定位
🔥Redis从入门到精通与实战🔥	Redis从入门到精通与实战	围绕原理源码讲解Redis面试知识点与实战
🔥MySQL从入门到精通🔥	MySQL从入门到精通	全面讲解MySQL知识与企业级MySQL实战
🔥计算机底层原理🔥	深入理解计算机系统CSAPP	以深入理解计算机系统为基石，构件计算机体系和计算机思维
	Linux内核源码解析	围绕Linux内核讲解计算机底层原理与并发
🔥数据结构与企业题库精讲🔥	数据结构与企业题库精讲	结合工作经验深入浅出，适合各层次，笔试面试算法题精讲
🔥互联网架构分析与实战🔥	企业系统架构分析实践与落地	行业最前沿视角，专注于技术架构升级路线、架构实践
	互联网企业防资损实践	互联网金融公司的防资损方法论、代码与实践
🔥Java全栈白宝书🔥	精通Java8与函数式编程	本专栏以实战为基础，逐步深入Java8以及未来的编程模式
	深入理解JVM	详细介绍内存区域、字节码、方法底层，类加载和GC等知识
	深入理解高并发编程	深入Liunx内核、汇编、C++全方位理解并发编程
	Spring源码分析	Spring核心七IOC/AOP等源码分析
	MyBatis源码分析	MyBatis核心源码分析
	Java核心技术	只讲Java核心技术