feign客戶端HTTP狀態碼為204時 響應體被忽略的問題

Posted on by

feign客戶端HTTP狀態碼為204時 響應體被忽略

在使用 spring-cloud Greenwich.SR3 時遇到一個問題。因為服務端HTTP狀態碼按照rest風格設計，所以update一類操作的http狀態碼返回204。

HttpStatus.NO_CONTENT(204, "No Content")*

但是部分接口還是希望返回修改後的數據。所以返回體其實是有內容的

return ResponseEntity(data, HttpStatus.NO_CONTENT)

結果客戶端接收不到data值,修改成普通的200返回就可以收到瞭。

return ResponseEntity(data, HttpStatus.OK)

猜測feign對204狀態碼做瞭處理，畢竟204代表響應體為空。

HTTP狀態碼及其含義

開發Web項目的時候，因為環境搭建和配置的原因，經常會出現部署失敗的情況；搭建這個博客的時候，也因為php-admin缺少某些庫的原因，導致出現502的稀有的http狀態。平時不是很留意這些狀態碼信息，也不是很瞭解出現這種狀態的內在原因，每次出現都要查找。為瞭詳細梳理和備忘，整理一份http狀態碼及其含義的解析。

以下信息參考自：RFC 2616

Http狀態碼主要有5類：

1XX：信息狀態碼

  • 100 Continue：客戶端應當繼續發送請求。這個臨時響應是用來通知客戶端它的部分請求已經被服務器接收，且仍未被拒絕。客戶端應當繼續發送請求的剩餘部分，或者如果請求已經完成，忽略這個響應。服務器必須在請求完後向客戶端發送一個最終響應
  • 101 Switching Protocols：服務器已經理解瞭客戶端的請求，並將通過Upgrade消息頭通知客戶端采用不同的協議來完成這個請求。在發送完這個響應最後的空行後，服務器將會切換到Upgrade消息頭中定義的那些協議。

2XX：成功狀態碼

  • 200 OK：請求成功，請求所希望的響應頭或數據體將隨此響應返回
  • 201 Created：表示服務器在請求的響應中建立瞭新文檔；應在定位頭信息中給出它的URL。
  • 202 Accepted：告訴客戶端請求正在被執行，但還沒有處理完。
  • 203 Non-Authoritative Information：表示文檔被正常的返回，但是由於正在使用的是文檔副本所以某些響應頭信息可能不正確。（HTTP 1.1新）。
  • 204 No Content：沒有新文檔，瀏覽器應該繼續顯示原來的文檔。如果用戶定期地刷新頁面，而Servlet可以確定用戶文檔足夠新，這個狀態代碼是很有用的。
  • 205 Reset Content：沒有新的內容，但瀏覽器應該重置它所顯示的內容。用來強制瀏覽器清除表單輸入內容（HTTP 1.1新）。
  • 206 Partial Content：客戶發送瞭一個帶有Range頭的GET請求，服務器完成瞭它（HTTP 1.1新）。

3XX：重定向

  • 300 Multiple Choices：客戶請求的文檔可以在多個位置找到，這些位置已經在返回的文檔內列出。如果服務器要提出優先選擇，則應該在Location應答頭指明。
  • 301 Moved Permanently：客戶請求的文檔在其他地方，新的URL在Location頭中給出，瀏覽器應該自動地訪問新的URL。
  • 302 Found：類似於301，但新的URL應該被視為臨時性的替代，而不是永久性的。註意，在HTTP1.0中對應的狀態信息是“Moved Temporatily”。出現該狀態代碼時，瀏覽器能夠自動訪問新的URL，因此它是一個很有用的狀態代碼。註意這個狀態代碼有時候可以和301替換使用。例如，如果瀏覽器錯誤地請求http://host/~user（缺少瞭後面的斜杠），有的服務器 返回301，有的則返回302。嚴格地說，我們隻能假定隻有當原來的請求是GET時瀏覽器才會自動重定向。請參見307。
  • 303 See Other：類似於301/302，不同之處在於，如果原來的請求是POST，Location頭指定的重定向目標文檔應該通過GET提取（HTTP 1.1新）。
  • 304 Not Modified：客戶端有緩沖的文檔並發出瞭一個條件性的請求（一般是提供If-Modified-Since頭表示客戶隻想比指定日期更新的文檔）。服務器告 訴客戶，原來緩沖的文檔還可以繼續使用。
  • 305 Use Proxy：客戶請求的文檔應該通過Location頭所指明的代理服務器提取（HTTP 1.1新）。
  • 306 （unused）：未使用。
  • 307 Temporary Redirect：和302 （Found）相同。許多瀏覽器會錯誤地響應302應答進行重定向，即使原來的請求是POST，即使它實際上隻能在POST請求的應答是303時才能重定 向。由於這個原因，HTTP 1.1新增瞭307，以便更加清除地區分幾個狀態代碼：當出現303應答時，瀏覽器可以跟隨重定向的GET和POST請求；如果是307應答，則瀏覽器隻 能跟隨對GET請求的重定向。（HTTP 1.1新）

4XX：客戶端錯誤

  • 400 Bad Request：請求出現語法錯誤
  • 401 Unauthorized：客戶試圖未經授權訪問受密碼保護的頁面。應答中會包含一個WWW-Authenticate頭，瀏覽器據此顯示用戶名字/密碼對話框，然後在填 寫合適的Authorization頭後再次發出請求。
  • 402 Payment Required：未使用。
  • 403 Forbidden：資源不可用。服務器理解客戶的請求，但拒絕處理它。通常由於服務器上文件或目錄的權限設置導致。
  • 404 Not Found：無法找到指定位置的資源。這也是一個常用的應答。
  • 405 Method Not Allowed：請求方法（GET、POST、HEAD、DELETE、PUT、TRACE等）對指定的資源不適用。（HTTP 1.1新）
  • 406 Not Acceptable：指定的資源已經找到，但它的MIME類型和客戶在Accpet頭中所指定的不兼容（HTTP 1.1新）。
  • 407 Proxy Authentication Required：類似於401，表示客戶必須先經過代理服務器的授權。（HTTP 1.1新）
  • 408 Request Timeout：在服務器許可的等待時間內，客戶一直沒有發出任何請求。客戶可以在以後重復同一請求。（HTTP 1.1新）
  • 409 Conflict：通常和PUT請求有關。由於請求和資源的當前狀態相沖突，因此請求不能成功。（HTTP 1.1新）
  • 410 Gone：所請求的文檔已經不再可用，而且服務器不知道應該重定向到哪一個地址。它和404的不同在於，返回407表示文檔永久地離開瞭指定的位置，而 404表示由於未知的原因文檔不可用。（HTTP 1.1新）
  • 411 Length Required：服務器不能處理請求，除非客戶發送一個Content-Length頭。（HTTP 1.1新）
  • 412 Precondition Failed：請求頭中指定的一些前提條件失敗（HTTP 1.1新）。
  • 413 Request Entity Too Large：目標文檔的大小超過服務器當前願意處理的大小。如果服務器認為自己能夠稍後再處理該請求，則應該提供一個Retry-After頭（HTTP 1.1新）。
  • 414 Request-URI Too Long：URI太長（HTTP 1.1新）。
  • 415 Unsupported Media Type：請求所帶的附件的格式類型服務器不知道如何處理。（HTTP 1.1新）
  • 416 Requested Range Not Satisfiable：服務器不能滿足客戶在請求中指定的Range頭。（HTTP 1.1新）
  • 417 Expectation Failed：如果服務器得到一個帶有100-continue值的Expect請求頭信息，這是指客戶端正在詢問是否可以在後面的請求中發送附件。在這種情況下，服務器也會用該狀態(417)告訴瀏覽器服務器不接收該附件或用100 (SC_CONTINUE)狀態告訴客戶端可以繼續發送附件。（HTTP 1.1新）

5XX: 服務器錯誤

  • 500 Internal Server Error：服務器遇到瞭意料不到的情況，不能完成客戶的請求。
  • 501 Not Implemented：服務器不支持實現請求所需要的功能。例如，客戶發出瞭一個服務器不支持的PUT請求。
  • 502 Bad Gateway：服務器作為網關或者代理時，為瞭完成請求訪問下一個服務器，但該服務器返回瞭非法的應答。
  • 503 Service Unavailable：服務器由於維護或者負載過重未能應答。例如，Servlet可能在數據庫連接池已滿的情況下返回503。服務器返回503時可以提供一個 Retry-After頭。
  • 504 Gateway Timeout：由作為代理或網關的服務器使用，表示不能及時地從遠程服務器獲得應答。（HTTP 1.1新）
  • 505 HTTP Version Not Supported：服務器不支持請求中所指明的HTTP版本。（HTTP 1.1新）

以上是各種http狀態碼的含義，熟悉瞭以上信息，在Web開發中對於debug有很大的意義，可以更快地定位到bug所在。希望能給大傢一個參考，也希望大傢多多支持WalkonNet。

推薦閱讀：