1. 程式人生 > >iOS網路請求的錯誤狀態碼

iOS網路請求的錯誤狀態碼

1xx訊息

這一型別的狀態碼,代表請求已被接受,需要繼續處理。這類響應是臨時響應,只包含狀態行和某些可選的響應頭資訊,並以空行結束。由於HTTP/1.0協議中沒有定義任何1xx狀態碼,所以除非在某些試驗條件下,伺服器禁止向此類客戶端傳送1xx響應。 這些狀態碼代表的響應都是資訊性的,標示客戶應該採取的其他行動。

100 Continue
    客戶端應當繼續傳送請求。這個臨時響應是用來通知客戶端它的部分請求已經被伺服器接收,且仍未被拒絕。客戶端應當繼續傳送請求的剩餘部分,或者如果請求已經完成,忽略這個響應。伺服器必須在請求完成後向客戶端傳送一個最終響應。
101 Switching Protocols
    伺服器已經理解了客戶端的請求,並將通過Upgrade訊息頭通知客戶端採用不同的協議來完成這個請求。在傳送完這個響應最後的空行後,伺服器將會切換到在Upgrade訊息頭中定義的那些協議。: 只有在切換新的協議更有好處的時候才應該採取類似措施。例如,切換到新的HTTP版本比舊版本更有優勢,或者切換到一個實時且同步的協議以傳送利用此類特性的資源。
102 Processing
    由WebDAV(RFC 2518)擴充套件的狀態碼,代表處理將被繼續執行。

2xx成功

這一型別的狀態碼,代表請求已成功被伺服器接收、理解、並接受。

200 OK
    請求已成功,請求所希望的響應頭或資料體將隨此響應返回。
201 Created
    請求已經被實現,而且有一個新的資源已經依據請求的需要而建立,且其URI已經隨Location頭資訊返回。假如需要的資源無法及時建立的話,應當返回'202 Accepted'。
202 Accepted
    伺服器已接受請求,但尚未處理。正如它可能被拒絕一樣,最終該請求可能會也可能不會被執行。在非同步操作的場合下,沒有比傳送這個狀態碼更方便的做法了。:返回202狀態碼的響應的目的是允許伺服器接受其他過程的請求(例如某個每天只執行一次的基於批處理的操作),而不必讓客戶端一直保持與伺服器的連線直到批處理操作全部完成。在接受請求處理並返回202狀態碼的響應應當在返回的實體中包含一些指示處理當前狀態的資訊,以及指向處理狀態監視器或狀態預測的指標,以便使用者能夠估計操作是否已經完成。
203 Non-Authoritative Information
    伺服器已成功處理了請求,但返回的實體頭部元資訊不是在原始伺服器上有效的確定集合,而是來自本地或者第三方的拷貝。當前的資訊可能是原始版本的子集或者超集。例如,包含資源的元資料可能導致原始伺服器知道元資訊的超集。使用此狀態碼不是必須的,而且只有在響應不使用此狀態碼便會返回200 OK的情況下才是合適的。
204 No Content
    伺服器成功處理了請求,但不需要返回任何實體內容,並且希望返回更新了的元資訊。響應可能通過實體頭部的形式,返回新的或更新後的元資訊。如果存在這些頭部資訊,則應當與所請求的變數相呼應。
    如果客戶端是瀏覽器的話,那麼使用者瀏覽器應保留髮送了該請求的頁面,而不產生任何文件檢視上的變化,即使按照規範新的或更新後的元資訊應當被應用到使用者瀏覽器活動檢視中的文件。
    由於204響應被禁止包含任何訊息體,因此它始終以訊息頭後的第一個空行結尾。
205 Reset Content
    伺服器成功處理了請求,且沒有返回任何內容。但是與204響應不同,返回此狀態碼的響應要求請求者重置文件檢視。該響應主要是被用於接受使用者輸入後,立即重置表單,以便使用者能夠輕鬆地開始另一次輸入。
    與204響應一樣,該響應也被禁止包含任何訊息體,且以訊息頭後的第一個空行結束。
206 Partial Content
    伺服器已經成功處理了部分GET請求。類似於FlashGet或者迅雷這類的HTTP 下載工具都是使用此類響應實現斷點續傳或者將一個大文件分解為多個下載段同時下載。
    該請求必須包含Range頭資訊來指示客戶端希望得到的內容範圍,並且可能包含If-Range來作為請求條件。
    響應必須包含如下的頭部域:

        Content-Range用以指示本次響應中返回的內容的範圍;如果是Content-Type為multipart/byteranges的多段下載,則每一multipart段中都應包含Content-Range域用以指示本段的內容範圍。假如響應中包含Content-Length,那麼它的數值必須匹配它返回的內容範圍的真實位元組數。
        Date
        ETag和/或Content-Location,假如同樣的請求本應該返回200響應。
        Expires, Cache-Control,和/或Vary,假如其值可能與之前相同變數的其他響應對應的值不同的話。

    假如本響應請求使用了If-Range強快取驗證,那麼本次響應不應該包含其他實體頭;假如本響應的請求使用了If-Range弱快取驗證,那麼本次響應禁止包含其他實體頭;這避免了快取的實體內容和更新了的實體頭資訊之間的不一致。否則,本響應就應當包含所有本應該返回200響應中應當返回的所有實體頭部域。
    假如ETag或Last-Modified頭部不能精確匹配的話,則客戶端快取應禁止將206響應返回的內容與之前任何快取過的內容組合在一起。
    任何不支援Range以及Content-Range頭的快取都禁止快取206響應返回的內容。
207 Multi-Status
    由WebDAV(RFC 2518)擴充套件的狀態碼,代表之後的訊息體將是一個XML訊息,並且可能依照之前子請求數量的不同,包含一系列獨立的響應程式碼。

3xx重定向

這類狀態碼代表需要客戶端採取進一步的操作才能完成請求。通常,這些狀態碼用來重定向,後續的請求地址(重定向目標)在本次響應的Location域中指明。

當且僅當後續的請求所使用的方法是GET或者HEAD時,使用者瀏覽器才可以在沒有使用者介入的情況下自動提交所需要的後續請求。客戶端應當自動監測無限迴圈重定向(例如:A→B→C→……→A或A→A),因為這會導致伺服器和客戶端大量不必要的資源消耗。按照HTTP/1.0版規範的建議,瀏覽器不應自動訪問超過5次的重定向。

300 Multiple Choices
    被請求的資源有一系列可供選擇的回饋資訊,每個都有自己特定的地址和瀏覽器驅動的商議資訊。使用者或瀏覽器能夠自行選擇一個首選的地址進行重定向。
    除非這是一個HEAD請求,否則該響應應當包括一個資源特性及地址的列表的實體,以便使用者或瀏覽器從中選擇最合適的重定向地址。這個實體的格式由Content-Type定義的格式所決定。瀏覽器可能根據響應的格式以及瀏覽器自身能力,自動作出最合適的選擇。當然,RFC 2616規範並沒有規定這樣的自動選擇該如何進行。
    如果伺服器本身已經有了首選的回饋選擇,那麼在Location中應當指明這個回饋的URI;瀏覽器可能會將這個Location值作為自動重定向的地址。此外,除非額外指定,否則這個響應也是可快取的。
301 Moved Permanently
    被請求的資源已永久移動到新位置,並且將來任何對此資源的引用都應該使用本響應返回的若干個URI之一。如果可能,擁有連結編輯功能的客戶端應當自動把請求的地址修改為從伺服器反饋回來的地址。除非額外指定,否則這個響應也是可快取的。
    新的永久性的URI應當在響應的Location域中返回。除非這是一個HEAD請求,否則響應的實體中應當包含指向新的URI的超連結及簡短說明。
    如果這不是一個GET或者HEAD請求,因此瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。
    注意:對於某些使用HTTP/1.0協議的瀏覽器,當它們傳送的POST請求得到了一個301響應的話,接下來的重定向請求將會變成GET方式。
302 Found
    請求的資源現在臨時從不同的URI響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有地址傳送以後的請求。只有在Cache-Control或Expires中進行了指定的情況下,這個響應才是可快取的。
    新的臨時性的URI應當在響應的Location域中返回。除非這是一個HEAD請求,否則響應的實體中應當包含指向新的URI的超連結及簡短說明。
    如果這不是一個GET或者HEAD請求,那麼瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。
    注意:雖然RFC 1945和RFC 2068規範不允許客戶端在重定向時改變請求的方法,但是很多現存的瀏覽器將302響應視作為303響應,並且使用GET方式訪問在Location中規定的URI,而無視原先請求的方法。狀態碼303和307被添加了進來,用以明確伺服器期待客戶端進行何種反應。
303 See Other
    對應當前請求的響應可以在另一個URI上被找到,而且客戶端應當採用GET的方式訪問那個資源。這個方法的存在主要是為了允許由指令碼啟用的POST請求輸出重定向到一個新的資源。這個新的URI不是原始資源的替代引用。同時,303響應禁止被快取。當然,第二個請求(重定向)可能被快取。
    新的URI應當在響應的Location域中返回。除非這是一個HEAD請求,否則響應的實體中應當包含指向新的URI的超連結及簡短說明。
    注意:許多HTTP/1.1版以前的瀏覽器不能正確理解303狀態。如果需要考慮與這些瀏覽器之間的互動,302狀態碼應該可以勝任,因為大多數的瀏覽器處理302響應時的方式恰恰就是上述規範要求客戶端處理303響應時應當做的。
304 Not Modified
    如果客戶端傳送了一個帶條件的GET請求且該請求已被允許,而文件的內容(自上次訪問以來或者根據請求的條件)並沒有改變,則伺服器應當返回這個狀態碼。304響應禁止包含訊息體,因此始終以訊息頭後的第一個空行結尾。
    該響應必須包含以下的頭資訊:

        Date,除非這個伺服器沒有時鐘。假如沒有時鐘的伺服器也遵守這些規則,那麼代理伺服器以及客戶端可以自行將Date欄位新增到接收到的響應頭中去(正如RFC 2068中規定的一樣),快取機制將會正常工作。
        ETag和/或Content-Location,假如同樣的請求本應返回200響應。
        Expires, Cache-Control,和/或Vary,假如其值可能與之前相同變數的其他響應對應的值不同的話。

    假如本響應請求使用了強快取驗證,那麼本次響應不應該包含其他實體頭;否則(例如,某個帶條件的GET請求使用了弱快取驗證),本次響應禁止包含其他實體頭;這避免了快取了的實體內容和更新了的實體頭資訊之間的不一致。
    假如某個304響應指明瞭當前某個實體沒有快取,那麼快取系統必須忽視這個響應,並且重複傳送不包含限制條件的請求。
    假如接收到一個要求更新某個快取條目的304響應,那麼快取系統必須更新整個條目以反映所有在響應中被更新的欄位的值。
305 Use Proxy
    被請求的資源必須通過指定的代理才能被訪問。Location域中將給出指定的代理所在的URI資訊,接收者需要重複傳送一個單獨的請求,通過這個代理才能訪問相應資源。只有原始伺服器才能建立305響應。
    注意:RFC 2068中沒有明確305響應是為了重定向一個單獨的請求,而且只能被原始伺服器建立。忽視這些限制可能導致嚴重的安全後果。
306 Switch Proxy
    在最新版的規範中,306狀態碼已經不再被使用。
307 Temporary Redirect
    請求的資源現在臨時從不同的URI響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有地址傳送以後的請求。只有在Cache-Control或Expires中進行了指定的情況下,這個響應才是可快取的。
    新的臨時性的URI應當在響應的Location域中返回。除非這是一個HEAD請求,否則響應的實體中應當包含指向新的URI的超連結及簡短說明。因為部分瀏覽器不能識別307響應,因此需要新增上述必要資訊以便使用者能夠理解並向新的URI發出訪問請求。
    如果這不是一個GET或者HEAD請求,那麼瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。

4xx客戶端錯誤

這類的狀態碼代表了客戶端看起來可能發生了錯誤,妨礙了伺服器的處理。除非響應的是一個HEAD請求,否則伺服器就應該返回一個解釋當前錯誤狀況的實體,以及這是臨時的還是永久性的狀況。這些狀態碼適用於任何請求方法。瀏覽器應當向用戶顯示任何包含在此類錯誤響應中的實體內容。

如果錯誤發生時客戶端正在傳送資料,那麼使用TCP的伺服器實現應當仔細確保在關閉客戶端與伺服器之間的連線之前,客戶端已經收到了包含錯誤資訊的資料包。如果客戶端在收到錯誤資訊後繼續向伺服器傳送資料,伺服器的TCP棧將向客戶端傳送一個重置資料包,以清除該客戶端所有還未識別的輸入緩衝,以免這些資料被伺服器上的應用程式讀取並干擾後者。

400 Bad Request
    由於包含語法錯誤,當前請求無法被伺服器理解。除非進行修改,否則客戶端不應該重複提交這個請求。
401 Unauthorized
    當前請求需要使用者驗證。該響應必須包含一個適用於被請求資源的WWW-Authenticate資訊頭用以詢問使用者資訊。客戶端可以重複提交一個包含恰當的Authorization頭資訊的請求。如果當前請求已經包含了Authorization證書,那麼401響應代表著伺服器驗證已經拒絕了那些證書。如果401響應包含了與前一個響應相同的身份驗證詢問,且瀏覽器已經至少嘗試了一次驗證,那麼瀏覽器應當向用戶展示響應中包含的實體資訊,因為這個實體資訊中可能包含了相關診斷資訊。參見RFC 2617。
402 Payment Required
    該狀態碼是為了將來可能的需求而預留的。
403 Forbidden
    伺服器已經理解請求,但是拒絕執行它。與401響應不同的是,身份驗證並不能提供任何幫助,而且這個請求也不應該被重複提交。如果這不是一個HEAD請求,而且伺服器希望能夠講清楚為何請求不能被執行,那麼就應該在實體內描述拒絕的原因。當然伺服器也可以返回一個404響應,假如它不希望讓客戶端獲得任何資訊。
404 Not Found
    請求失敗,請求所希望得到的資源未被在伺服器上發現。沒有資訊能夠告訴使用者這個狀況到底是暫時的還是永久的。假如伺服器知道情況的話,應當使用410狀態碼來告知舊資源因為某些內部的配置機制問題,已經永久的不可用,而且沒有任何可以跳轉的地址。404這個狀態碼被廣泛應用於當伺服器不想揭示到底為何請求被拒絕或者沒有其他適合的響應可用的情況下。
405 Method Not Allowed
    請求行中指定的請求方法不能被用於請求相應的資源。該響應必須返回一個Allow頭資訊用以表示出當前資源能夠接受的請求方法的列表。
    鑑於PUT,DELETE方法會對伺服器上的資源進行寫操作,因而絕大部分的網頁伺服器都不支援或者在預設配置下不允許上述請求方法,對於此類請求均會返回405錯誤。
406 Not Acceptable
    請求的資源的內容特性無法滿足請求頭中的條件,因而無法生成響應實體。
    除非這是一個HEAD請求,否則該響應就應當返回一個包含可以讓使用者或者瀏覽器從中選擇最合適的實體特性以及地址列表的實體。實體的格式由Content-Type頭中定義的媒體型別決定。瀏覽器可以根據格式及自身能力自行作出最佳選擇。但是,規範中並沒有定義任何作出此類自動選擇的標準。
407 Proxy Authentication Required
    與401響應類似,只不過客戶端必須在代理伺服器上進行身份驗證。代理伺服器必須返回一個Proxy-Authenticate用以進行身份詢問。客戶端可以返回一個Proxy-Authorization資訊頭用以驗證。參見RFC 2617。
408 Request Timeout
    請求超時。客戶端沒有在伺服器預備等待的時間內完成一個請求的傳送。客戶端可以隨時再次提交這一請求而無需進行任何更改。
409 Conflict
    由於和被請求的資源的當前狀態之間存在衝突,請求無法完成。這個程式碼只允許用在這樣的情況下才能被使用:使用者被認為能夠解決衝突,並且會重新提交新的請求。該響應應當包含足夠的資訊以便使用者發現衝突的源頭。
    衝突通常發生於對PUT請求的處理中。例如,在採用版本檢查的環境下,某次PUT提交的對特定資源的修改請求所附帶的版本資訊與之前的某個(第三方)請求向衝突,那麼此時伺服器就應該返回一個409錯誤,告知使用者請求無法完成。此時,響應實體中很可能會包含兩個衝突版本之間的差異比較,以便使用者重新提交歸併以後的新版本。
410 Gone
    被請求的資源在伺服器上已經不再可用,而且沒有任何已知的轉發地址。這樣的狀況應當被認為是永久性的。如果可能,擁有連結編輯功能的客戶端應當在獲得使用者許可後刪除所有指向這個地址的引用。如果伺服器不知道或者無法確定這個狀況是否是永久的,那麼就應該使用404狀態碼。除非額外說明,否則這個響應是可快取的。
    410響應的目的主要是幫助網站管理員維護網站,通知使用者該資源已經不再可用,並且伺服器擁有者希望所有指向這個資源的遠端連線也被刪除。這類事件在限時、增值服務中很普遍。同樣,410響應也被用於通知客戶端在當前伺服器站點上,原本屬於某個個人的資源已經不再可用。當然,是否需要把所有永久不可用的資源標記為'410 Gone',以及是否需要保持此標記多長時間,完全取決於伺服器擁有者。
411 Length Required
    伺服器拒絕在沒有定義Content-Length頭的情況下接受請求。在添加了表明請求訊息體長度的有效Content-Length頭之後,客戶端可以再次提交該請求。
412 Precondition Failed
    伺服器在驗證在請求的頭欄位中給出先決條件時,沒能滿足其中的一個或多個。這個狀態碼允許客戶端在獲取資源時在請求的元資訊(請求頭欄位資料)中設定先決條件,以此避免該請求方法被應用到其希望的內容以外的資源上。
413 Request Entity Too Large
    伺服器拒絕處理當前請求,因為該請求提交的實體資料大小超過了伺服器願意或者能夠處理的範圍。此種情況下,伺服器可以關閉連線以免客戶端繼續傳送此請求。
    如果這個狀況是臨時的,伺服器應當返回一個Retry-After的響應頭,以告知客戶端可以在多少時間以後重新嘗試。
414 Request-URI Too Long
    請求的URI長度超過了伺服器能夠解釋的長度,因此伺服器拒絕對該請求提供服務。這比較少見,通常的情況包括:

        本應使用POST方法的表單提交變成了GET方法,導致查詢字串(Query String)過長。