已解決org.springframework.web.HttpMediaTypeNotAcceptableException異常的正確解決方法，親測有效！！！

文章目錄

問題分析

報錯原因

解決思路

解決方法

總結(jié)

---

問題分析

在Spring MVC應(yīng)用中處理HTTP請求時，我們有時會遇到org.springframework.web.HttpMediaTypeNotAcceptableException。這個異常通常發(fā)生在客戶端請求指定的Accept頭信息沒有包含任何服務(wù)器可以生成的響應(yīng)類型，或者Controller層無法提供客戶端所能接受的媒體類型的數(shù)據(jù)。

?

報錯原因

該異?？赡苁怯梢韵聨讉€原因?qū)е碌?#xff1a;

1. 客戶端的Accept頭不正確：客戶端在發(fā)送請求時，Accept頭參數(shù)錯誤或過于限制性。
2. 服務(wù)端缺少相應(yīng)的消息轉(zhuǎn)換器：服務(wù)器未配置能夠產(chǎn)生客戶端所接受媒體類型的消息轉(zhuǎn)換器。
3. Controller方法不支持Accept頭要求的返回類型：例如，一個REST API僅返回JSON，但客戶端請求了XML格式。

?

解決思路

解決這個問題需要確保Spring MVC能夠為客戶端請求提供適當?shù)捻憫?yīng)格式。具體步驟包括：

1. 客戶端調(diào)整：更新或修正客戶端請求的Accept頭信息，使之符合服務(wù)器能提供的媒體類型。
2. 服務(wù)端配置：在服務(wù)端添加或修改消息轉(zhuǎn)換器，以支持更多的響應(yīng)類型。
3. 編碼實踐：開發(fā)時需注意Controller的返回類型與客戶端可接受的類型保持一致性。

?

解決方法

針對上述思路，下面是解決HttpMediaTypeNotAcceptableException異常的詳細步驟：

• 客戶端請求檢查：首先，檢查造成問題的HTTP請求，特別是Accept頭部分。比如，在使用curl進行請求時，需要檢查-H "Accept: application/json"等類似的部分是否符合預(yù)期。

• 配置消息轉(zhuǎn)換器：如果確定客戶端的Accept頭沒有問題，則需要在Spring MVC配置中添加或確認消息轉(zhuǎn)換器。你可以通過實現(xiàn)WebMvcConfigurer接口并重寫configureMessageConverters方法來添加或擴展消息轉(zhuǎn)換器。

  @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頭相匹配。

• 后備消息轉(zhuǎn)換器：在某些情況下，你可能需要配置一個后備消息轉(zhuǎn)換器，允許你的API至少返回一種默認的媒體類型，即使它不是客戶端明確請求的類型。

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

• 測試驗證：完成以上步驟后，重新啟動Spring應(yīng)用并使用工具（例如Postman）來測試API，驗證問題是否已經(jīng)解決。

總結(jié)

在處理org.springframework.web.HttpMediaTypeNotAcceptableException時，關(guān)鍵是理解HTTP請求和響應(yīng)中的媒體類型協(xié)商機制。通過調(diào)整客戶端的請求頭、確保服務(wù)端配置了適當?shù)南⑥D(zhuǎn)換器，并且Controller層能夠提供各種媒體類型，可以有效地避免這一異常。緊密跟蹤Spring框架的最佳實踐，可以幫助開發(fā)人員構(gòu)建出既靈活又健壯的Web服務(wù)。希望這篇文章能幫助你解決HttpMediaTypeNotAcceptableException異常，確保你的Web應(yīng)用能夠順利處理各種復(fù)雜的HTTP請求。

?以上是此問題報錯原因的解決方法，歡迎評論區(qū)留言討論是否能解決，如果本文對你有幫助 歡迎 關(guān)注?、點贊?、收藏?、評論，?博主才有動力持續(xù)記錄遇到的問題！！！

博主v：XiaoMing_Java

?📫作者簡介：嗨，大家好，我是?小明java問道之路，互聯(lián)網(wǎng)大廠后端研發(fā)專家，2022博客之星TOP3 / 博客專家 / CSDN后端內(nèi)容合伙人、InfoQ(極客時間)簽約作者、阿里云簽約博主、全網(wǎng)5萬粉絲博主。

---

🍅 文末獲取聯(lián)系 🍅??👇🏻 精彩專欄推薦訂閱收藏 👇🏻

專欄系列（點擊解鎖）	學(xué)習(xí)路線（點擊解鎖）	知識定位
🔥Redis從入門到精通與實戰(zhàn)🔥	Redis從入門到精通與實戰(zhàn)	圍繞原理源碼講解Redis面試知識點與實戰(zhàn)
🔥MySQL從入門到精通🔥	MySQL從入門到精通	全面講解MySQL知識與企業(yè)級MySQL實戰(zhàn)
🔥計算機底層原理🔥	深入理解計算機系統(tǒng)CSAPP	以深入理解計算機系統(tǒng)為基石，構(gòu)件計算機體系和計算機思維
	Linux內(nèi)核源碼解析	圍繞Linux內(nèi)核講解計算機底層原理與并發(fā)
🔥數(shù)據(jù)結(jié)構(gòu)與企業(yè)題庫精講🔥	數(shù)據(jù)結(jié)構(gòu)與企業(yè)題庫精講	結(jié)合工作經(jīng)驗深入淺出，適合各層次，筆試面試算法題精講
🔥互聯(lián)網(wǎng)架構(gòu)分析與實戰(zhàn)🔥	企業(yè)系統(tǒng)架構(gòu)分析實踐與落地	行業(yè)最前沿視角，專注于技術(shù)架構(gòu)升級路線、架構(gòu)實踐
	互聯(lián)網(wǎng)企業(yè)防資損實踐	互聯(lián)網(wǎng)金融公司的防資損方法論、代碼與實踐
🔥Java全棧白寶書🔥	精通Java8與函數(shù)式編程	本專欄以實戰(zhàn)為基礎(chǔ)，逐步深入Java8以及未來的編程模式
	深入理解JVM	詳細介紹內(nèi)存區(qū)域、字節(jié)碼、方法底層，類加載和GC等知識
	深入理解高并發(fā)編程	深入Liunx內(nèi)核、匯編、C++全方位理解并發(fā)編程
	Spring源碼分析	Spring核心七IOC/AOP等源碼分析
	MyBatis源碼分析	MyBatis核心源碼分析
	Java核心技術(shù)	只講Java核心技術(shù)