HTTP狀態(tài)碼詳解
2021-07-03
| 狀態(tài)碼 | 含義 |
|---|---|
| 100 | 客戶端應當繼續(xù)發(fā)送請求。這個臨時響應是用來通知客戶端它的部分請求已經(jīng)被服務(wù)器接收，且仍未被拒絕?？蛻舳藨斃^續(xù)發(fā)送請求的剩余部分，或者如果請求已經(jīng)完成，忽略這個響應。服務(wù)器必須在請求完成后向客戶端發(fā)送一個最終響應。 |
| 101 | 服務(wù)器已經(jīng)理解了客戶端的請求，并將通過Upgrade 消息頭通知客戶端采用不同的協(xié)議來完成這個請求。在發(fā)送完這個響應最后的空行后，服務(wù)器將會切換到在Upgrade 消息頭中定義的那些協(xié)議。 只有在切換新的協(xié)議更有好處的時候才應該采取類似措施。例如，切換到新的HTTP 版本比舊版本更有優(yōu)勢，或者切換到一個實時且同步的協(xié)議以傳送利用此類特性的資源。 |
| 102 | 由WebDAV（RFC 2518）擴展的狀態(tài)碼，代表處理將被繼續(xù)執(zhí)行。 |
| 200 | 請求已成功，請求所希望的響應頭或數(shù)據(jù)體將隨此響應返回。 |
| 201 | 請求已經(jīng)被實現(xiàn)，而且有一個新的資源已經(jīng)依據(jù)請求的需要而建立，且其 URI 已經(jīng)隨Location 頭信息返回。假如需要的資源無法及時建立的話，應當返回 '202 Accepted'。 |
| 202 | 服務(wù)器已接受請求，但尚未處理。正如它可能被拒絕一樣，最終該請求可能會也可能不會被執(zhí)行。在異步操作的場合下，沒有比發(fā)送這個狀態(tài)碼更方便的做法了。 返回202狀態(tài)碼的響應的目的是允許服務(wù)器接受其他過程的請求（例如某個每天只執(zhí)行一次的基于批處理的操作），而不必讓客戶端一直保持與服務(wù)器的連接直到批處理操作全部完成。在接受請求處理并返回202狀態(tài)碼的響應應當在返回的實體中包含一些指示處理當前狀態(tài)的信息，以及指向處理狀態(tài)監(jiān)視器或狀態(tài)預測的指針，以便用戶能夠估計操作是否已經(jīng)完成。 |
| 203 | 服務(wù)器已成功處理了請求，但返回的實體頭部元信息不是在原始服務(wù)器上有效的確定集合，而是來自本地或者第三方的拷貝。當前的信息可能是原始版本的子集或者超集。例如，包含資源的元數(shù)據(jù)可能導致原始服務(wù)器知道元信息的超級。使用此狀態(tài)碼不是必須的，而且只有在響應不使用此狀態(tài)碼便會返回200 OK的情況下才是合適的。 |
| 204 | 服務(wù)器成功處理了請求，但不需要返回任何實體內(nèi)容，并且希望返回更新了的元信息。響應可能通過實體頭部的形式，返回新的或更新后的元信息。如果存在這些頭部信息，則應當與所請求的變量相呼應。 如果客戶端是瀏覽器的話，那么用戶瀏覽器應保留發(fā)送了該請求的頁面，而不產(chǎn)生任何文檔視圖上的變化，即使按照規(guī)范新的或更新后的元信息應當被應用到用戶瀏覽器活動視圖中的文檔。 由于204響應被禁止包含任何消息體，因此它始終以消息頭后的第一個空行結(jié)尾。 |
| 205 | 服務(wù)器成功處理了請求，且沒有返回任何內(nèi)容。但是與204響應不同，返回此狀態(tài)碼的響應要求請求者重置文檔視圖。該響應主要是被用于接受用戶輸入后，立即重置表單，以便用戶能夠輕松地開始另一次輸入。 與204響應一樣，該響應也被禁止包含任何消息體，且以消息頭后的第一個空行結(jié)束。 |
| 206 | 服務(wù)器已經(jīng)成功處理了部分 GET 請求。類似于 FlashGet 或者迅雷這類的 HTTP 下載工具都是使用此類響應實現(xiàn)斷點續(xù)傳或者將一個大文檔分解為多個下載段同時下載。 該請求必須包含 Range 頭信息來指示客戶端希望得到的內(nèi)容范圍，并且可能包含 If-Range 來作為請求條件。 響應必須包含如下的頭部域： Content-Range 用以指示本次響應中返回的內(nèi)容的范圍；如果是 Content-Type 為 multipart/byteranges 的多段下載，則每一 multipart 段中都應包含 Content-Range 域用以指示本段的內(nèi)容范圍。假如響應中包含 Content-Length，那么它的數(shù)值必須匹配它返回的內(nèi)容范圍的真實字節(jié)數(shù)。 Date ETag 和/或 Content-Location，假如同樣的請求本應該返回200響應。 Expires, Cache-Control，和/或 Vary，假如其值可能與之前相同變量的其他響應對應的值不同的話。 假如本響應請求使用了 If-Range 強緩存驗證，那么本次響應不應該包含其他實體頭；假如本響應的請求使用了 If-Range 弱緩存驗證，那么本次響應禁止包含其他實體頭；這避免了緩存的實體內(nèi)容和更新了的實體頭信息之間的不一致。否則，本響應就應當包含所有本應該返回200響應中應當返回的所有實體頭部域。 假如 ETag 或 Last-Modified 頭部不能精確匹配的話，則客戶端緩存應禁止將206響應返回的內(nèi)容與之前任何緩存過的內(nèi)容組合在一起。 任何不支持 Range 以及 Content-Range 頭的緩存都禁止緩存206響應返回的內(nèi)容。 |
| 207 | 由WebDAV(RFC 2518)擴展的狀態(tài)碼，代表之后的消息體將是一個XML消息，并且可能依照之前子請求數(shù)量的不同，包含一系列獨立的響應代碼。 |
| 300 | 被請求的資源有一系列可供選擇的回饋信息，每個都有自己特定的地址和瀏覽器驅(qū)動的商議信息。用戶或瀏覽器能夠自行選擇一個首選的地址進行重定向。 除非這是一個 HEAD 請求，否則該響應應當包括一個資源特性及地址的列表的實體，以便用戶或瀏覽器從中選擇最合適的重定向地址。這個實體的格式由 Content-Type 定義的格式所決定。瀏覽器可能根據(jù)響應的格式以及瀏覽器自身能力，自動作出最合適的選擇。當然，RFC 2616規(guī)范并沒有規(guī)定這樣的自動選擇該如何進行。 如果服務(wù)器本身已經(jīng)有了首選的回饋選擇，那么在 Location 中應當指明這個回饋的 URI；瀏覽器可能會將這個 Location 值作為自動重定向的地址。此外，除非額外指定，否則這個響應也是可緩存的。 |
| 301 | 被請求的資源已永久移動到新位置，并且將來任何對此資源的引用都應該使用本響應返回的若干個 URI 之一。如果可能，擁有鏈接編輯功能的客戶端應當自動把請求的地址修改為從服務(wù)器反饋回來的地址。除非額外指定，否則這個響應也是可緩存的。 新的永久性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求，否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。 如果這不是一個 GET 或者 HEAD 請求，因此瀏覽器禁止自動進行重定向，除非得到用戶的確認，因為請求的條件可能因此發(fā)生變化。 注意：對于某些使用 HTTP/1.0 協(xié)議的瀏覽器，當它們發(fā)送的 POST 請求得到了一個301響應的話，接下來的重定向請求將會變成 GET 方式。 |
| 302 | 請求的資源現(xiàn)在臨時從不同的 URI 響應請求。由于這樣的重定向是臨時的，客戶端應當繼續(xù)向原有地址發(fā)送以后的請求。只有在Cache-Control或Expires中進行了指定的情況下，這個響應才是可緩存的。 新的臨時性的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求，否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。 如果這不是一個 GET 或者 HEAD 請求，那么瀏覽器禁止自動進行重定向，除非得到用戶的確認，因為請求的條件可能因此發(fā)生變化。 注意：雖然RFC 1945和RFC 2068規(guī)范不允許客戶端在重定向時改變請求的方法，但是很多現(xiàn)存的瀏覽器將302響應視作為303響應，并且使用 GET 方式訪問在 Location 中規(guī)定的 URI，而無視原先請求的方法。狀態(tài)碼303和307被添加了進來，用以明確服務(wù)器期待客戶端進行何種反應。 |
| 303 | 對應當前請求的響應可以在另一個 URI 上被找到，而且客戶端應當采用 GET 的方式訪問那個資源。這個方法的存在主要是為了允許由腳本激活的POST請求輸出重定向到一個新的資源。這個新的 URI 不是原始資源的替代引用。同時，303響應禁止被緩存。當然，第二個請求（重定向）可能被緩存。 新的 URI 應當在響應的 Location 域中返回。除非這是一個 HEAD 請求，否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。 注意：許多 HTTP/1.1 版以前的 瀏覽器不能正確理解303狀態(tài)。如果需要考慮與這些瀏覽器之間的互動，302狀態(tài)碼應該可以勝任，因為大多數(shù)的瀏覽器處理302響應時的方式恰恰就是上述規(guī)范要求客戶端處理303響應時應當做的。 |
| 304 | 如果客戶端發(fā)送了一個帶條件的 GET 請求且該請求已被允許，而文檔的內(nèi)容（自上次訪問以來或者根據(jù)請求的條件）并沒有改變，則服務(wù)器應當返回這個狀態(tài)碼。304響應禁止包含消息體，因此始終以消息頭后的第一個空行結(jié)尾。 該響應必須包含以下的頭信息： Date，除非這個服務(wù)器沒有時鐘。假如沒有時鐘的服務(wù)器也遵守這些規(guī)則，那么代理服務(wù)器以及客戶端可以自行將 Date 字段添加到接收到的響應頭中去（正如RFC 2068中規(guī)定的一樣），緩存機制將會正常工作。 ETag 和/或 Content-Location，假如同樣的請求本應返回200響應。 Expires, Cache-Control，和/或Vary，假如其值可能與之前相同變量的其他響應對應的值不同的話。 假如本響應請求使用了強緩存驗證，那么本次響應不應該包含其他實體頭；否則（例如，某個帶條件的 GET 請求使用了弱緩存驗證），本次響應禁止包含其他實體頭；這避免了緩存了的實體內(nèi)容和更新了的實體頭信息之間的不一致。 假如某個304響應指明了當前某個實體沒有緩存，那么緩存系統(tǒng)必須忽視這個響應，并且重復發(fā)送不包含限制條件的請求。 假如接收到一個要求更新某個緩存條目的304響應，那么緩存系統(tǒng)必須更新整個條目以反映所有在響應中被更新的字段的值。 |
| 305 | 被請求的資源必須通過指定的代理才能被訪問。Location 域中將給出指定的代理所在的 URI 信息，接收者需要重復發(fā)送一個單獨的請求，通過這個代理才能訪問相應資源。只有原始服務(wù)器才能建立305響應。 注意：RFC 2068中沒有明確305響應是為了重定向一個單獨的請求，而且只能被原始服務(wù)器建立。忽視這些限制可能導致嚴重的安全后果。 |
| 306 | 在最新版的規(guī)范中，306狀態(tài)碼已經(jīng)不再被使用。 |
| 307 | 請求的資源現(xiàn)在臨時從不同的URI 響應請求。由于這樣的重定向是臨時的，客戶端應當繼續(xù)向原有地址發(fā)送以后的請求。只有在Cache-Control或Expires中進行了指定的情況下，這個響應才是可緩存的。 新的臨時性的URI 應當在響應的 Location 域中返回。除非這是一個HEAD 請求，否則響應的實體中應當包含指向新的URI 的超鏈接及簡短說明。因為部分瀏覽器不能識別307響應，因此需要添加上述必要信息以便用戶能夠理解并向新的 URI 發(fā)出訪問請求。 如果這不是一個GET 或者 HEAD 請求，那么瀏覽器禁止自動進行重定向，除非得到用戶的確認，因為請求的條件可能因此發(fā)生變化。 |
| 400 | 1、語義有誤，當前請求無法被服務(wù)器理解。除非進行修改，否則客戶端不應該重復提交這個請求。 2、請求參數(shù)有誤。 |
| 401 | 當前請求需要用戶驗證。該響應必須包含一個適用于被請求資源的 WWW-Authenticate 信息頭用以詢問用戶信息?？蛻舳丝梢灾貜吞峤灰粋€包含恰當?shù)?Authorization 頭信息的請求。如果當前請求已經(jīng)包含了 Authorization 證書，那么401響應代表著服務(wù)器驗證已經(jīng)拒絕了那些證書。如果401響應包含了與前一個響應相同的身份驗證詢問，且瀏覽器已經(jīng)至少嘗試了一次驗證，那么瀏覽器應當向用戶展示響應中包含的實體信息，因為這個實體信息中可能包含了相關(guān)診斷信息。參見RFC 2617。 |
| 402 | 該狀態(tài)碼是為了將來可能的需求而預留的。 |
| 403 | 服務(wù)器已經(jīng)理解請求，但是拒絕執(zhí)行它。與401響應不同的是，身份驗證并不能提供任何幫助，而且這個請求也不應該被重復提交。如果這不是一個 HEAD 請求，而且服務(wù)器希望能夠講清楚為何請求不能被執(zhí)行，那么就應該在實體內(nèi)描述拒絕的原因。當然服務(wù)器也可以返回一個404響應，假如它不希望讓客戶端獲得任何信息。 |
| 404 | 請求失敗，請求所希望得到的資源未被在服務(wù)器上發(fā)現(xiàn)。沒有信息能夠告訴用戶這個狀況到底是暫時的還是永久的。假如服務(wù)器知道情況的話，應當使用410狀態(tài)碼來告知舊資源因為某些內(nèi)部的配置機制問題，已經(jīng)永久的不可用，而且沒有任何可以跳轉(zhuǎn)的地址。404這個狀態(tài)碼被廣泛應用于當服務(wù)器不想揭示到底為何請求被拒絕或者沒有其他適合的響應可用的情況下。 |
| 405 | 請求行中指定的請求方法不能被用于請求相應的資源。該響應必須返回一個Allow 頭信息用以表示出當前資源能夠接受的請求方法的列表。 鑒于 PUT，DELETE 方法會對服務(wù)器上的資源進行寫操作，因而絕大部分的網(wǎng)頁服務(wù)器都不支持或者在默認配置下不允許上述請求方法，對于此類請求均會返回405錯誤。 |
| 406 | 請求的資源的內(nèi)容特性無法滿足請求頭中的條件，因而無法生成響應實體。 除非這是一個 HEAD 請求，否則該響應就應當返回一個包含可以讓用戶或者瀏覽器從中選擇最合適的實體特性以及地址列表的實體。實體的格式由 Content-Type 頭中定義的媒體類型決定。瀏覽器可以根據(jù)格式及自身能力自行作出最佳選擇。但是，規(guī)范中并沒有定義任何作出此類自動選擇的標準。 |
| 407 | 與401響應類似，只不過客戶端必須在代理服務(wù)器上進行身份驗證。代理服務(wù)器必須返回一個 Proxy-Authenticate 用以進行身份詢問?？蛻舳丝梢苑祷匾粋€ Proxy-Authorization 信息頭用以驗證。參見RFC 2617。 |
| 408 | 請求超時。客戶端沒有在服務(wù)器預備等待的時間內(nèi)完成一個請求的發(fā)送?？蛻舳丝梢噪S時再次提交這一請求而無需進行任何更改。 |
| 409 | 由于和被請求的資源的當前狀態(tài)之間存在沖突，請求無法完成。這個代碼只允許用在這樣的情況下才能被使用：用戶被認為能夠解決沖突，并且會重新提交新的請求。該響應應當包含足夠的信息以便用戶發(fā)現(xiàn)沖突的源頭。 沖突通常發(fā)生于對 PUT 請求的處理中。例如，在采用版本檢查的環(huán)境下，某次 PUT 提交的對特定資源的修改請求所附帶的版本信息與之前的某個（第三方）請求向沖突，那么此時服務(wù)器就應該返回一個409錯誤，告知用戶請求無法完成。此時，響應實體中很可能會包含兩個沖突版本之間的差異比較，以便用戶重新提交歸并以后的新版本。 |
| 410 | 被請求的資源在服務(wù)器上已經(jīng)不再可用，而且沒有任何已知的轉(zhuǎn)發(fā)地址。這樣的狀況應當被認為是永久性的。如果可能，擁有鏈接編輯功能的客戶端應當在獲得用戶許可后刪除所有指向這個地址的引用。如果服務(wù)器不知道或者無法確定這個狀況是否是永久的，那么就應該使用404狀態(tài)碼。除非額外說明，否則這個響應是可緩存的。 410響應的目的主要是幫助網(wǎng)站管理員維護網(wǎng)站，通知用戶該資源已經(jīng)不再可用，并且服務(wù)器擁有者希望所有指向這個資源的遠端連接也被刪除。這類事件在限時、增值服務(wù)中很普遍。同樣，410響應也被用于通知客戶端在當前服務(wù)器站點上，原本屬于某個個人的資源已經(jīng)不再可用。當然，是否需要把所有永久不可用的資源標記為'410 Gone'，以及是否需要保持此標記多長時間，完全取決于服務(wù)器擁有者。 |
| 411 | 服務(wù)器拒絕在沒有定義 Content-Length 頭的情況下接受請求。在添加了表明請求消息體長度的有效 Content-Length 頭之后，客戶端可以再次提交該請求。 |
| 412 | 服務(wù)器在驗證在請求的頭字段中給出先決條件時，沒能滿足其中的一個或多個。這個狀態(tài)碼允許客戶端在獲取資源時在請求的元信息（請求頭字段數(shù)據(jù)）中設(shè)置先決條件，以此避免該請求方法被應用到其希望的內(nèi)容以外的資源上。 |
| 413 | 服務(wù)器拒絕處理當前請求，因為該請求提交的實體數(shù)據(jù)大小超過了服務(wù)器愿意或者能夠處理的范圍。此種情況下，服務(wù)器可以關(guān)閉連接以免客戶端繼續(xù)發(fā)送此請求。 如果這個狀況是臨時的，服務(wù)器應當返回一個 Retry-After 的響應頭，以告知客戶端可以在多少時間以后重新嘗試。 |
| 414 | 請求的URI 長度超過了服務(wù)器能夠解釋的長度，因此服務(wù)器拒絕對該請求提供服務(wù)。這比較少見，通常的情況包括： 本應使用POST方法的表單提交變成了GET方法，導致查詢字符串（Query String）過長。 重定向URI “黑洞”，例如每次重定向把舊的 URI 作為新的 URI 的一部分，導致在若干次重定向后 URI 超長。 客戶端正在嘗試利用某些服務(wù)器中存在的安全漏洞攻擊服務(wù)器。這類服務(wù)器使用固定長度的緩沖讀取或操作請求的 URI，當 GET 后的參數(shù)超過某個數(shù)值后，可能會產(chǎn)生緩沖區(qū)溢出，導致任意代碼被執(zhí)行[1]。沒有此類漏洞的服務(wù)器，應當返回414狀態(tài)碼。 |
| 415 | 對于當前請求的方法和所請求的資源，請求中提交的實體并不是服務(wù)器中所支持的格式，因此請求被拒絕。 |
| 416 | 如果請求中包含了 Range 請求頭，并且 Range 中指定的任何數(shù)據(jù)范圍都與當前資源的可用范圍不重合，同時請求中又沒有定義 If-Range 請求頭，那么服務(wù)器就應當返回416狀態(tài)碼。 假如 Range 使用的是字節(jié)范圍，那么這種情況就是指請求指定的所有數(shù)據(jù)范圍的首字節(jié)位置都超過了當前資源的長度。服務(wù)器也應當在返回416狀態(tài)碼的同時，包含一個 Content-Range 實體頭，用以指明當前資源的長度。這個響應也被禁止使用 multipart/byteranges 作為其 Content-Type。 |
| 417 | 在請求頭 Expect 中指定的預期內(nèi)容無法被服務(wù)器滿足，或者這個服務(wù)器是一個代理服務(wù)器，它有明顯的證據(jù)證明在當前路由的下一個節(jié)點上，Expect 的內(nèi)容無法被滿足。 |
| 421 | 從當前客戶端所在的IP地址到服務(wù)器的連接數(shù)超過了服務(wù)器許可的最大范圍。通常，這里的IP地址指的是從服務(wù)器上看到的客戶端地址（比如用戶的網(wǎng)關(guān)或者代理服務(wù)器地址）。在這種情況下，連接數(shù)的計算可能涉及到不止一個終端用戶。 |
| 422 | 從當前客戶端所在的IP地址到服務(wù)器的連接數(shù)超過了服務(wù)器許可的最大范圍。通常，這里的IP地址指的是從服務(wù)器上看到的客戶端地址（比如用戶的網(wǎng)關(guān)或者代理服務(wù)器地址）。在這種情況下，連接數(shù)的計算可能涉及到不止一個終端用戶。 |
| 422 | 請求格式正確，但是由于含有語義錯誤，無法響應。（RFC 4918 WebDAV）423 Locked 當前資源被鎖定。（RFC 4918 WebDAV） |
| 424 | 由于之前的某個請求發(fā)生的錯誤，導致當前請求失敗，例如 PROPPATCH。（RFC 4918 WebDAV） |
| 425 | 在WebDav Advanced Collections 草案中定義，但是未出現(xiàn)在《WebDAV 順序集協(xié)議》（RFC 3658）中。 |
| 426 | 客戶端應當切換到TLS/1.0。（RFC 2817） |
| 449 | 由微軟擴展，代表請求應當在執(zhí)行完適當?shù)牟僮骱筮M行重試。 |
| 500 | 服務(wù)器遇到了一個未曾預料的狀況，導致了它無法完成對請求的處理。一般來說，這個問題都會在服務(wù)器的程序碼出錯時出現(xiàn)。 |
| 501 | 服務(wù)器不支持當前請求所需要的某個功能。當服務(wù)器無法識別請求的方法，并且無法支持其對任何資源的請求。 |
| 502 | 作為網(wǎng)關(guān)或者代理工作的服務(wù)器嘗試執(zhí)行請求時，從上游服務(wù)器接收到無效的響應。 |
| 503 | 由于臨時的服務(wù)器維護或者過載，服務(wù)器當前無法處理請求。這個狀況是臨時的，并且將在一段時間以后恢復。如果能夠預計延遲時間，那么響應中可以包含一個 Retry-After 頭用以標明這個延遲時間。如果沒有給出這個 Retry-After 信息，那么客戶端應當以處理500響應的方式處理它。 注意：503狀態(tài)碼的存在并不意味著服務(wù)器在過載的時候必須使用它。某些服務(wù)器只不過是希望拒絕客戶端的連接。 |
| 504 | 作為網(wǎng)關(guān)或者代理工作的服務(wù)器嘗試執(zhí)行請求時，未能及時從上游服務(wù)器（URI標識出的服務(wù)器，例如HTTP、FTP、LDAP）或者輔助服務(wù)器（例如DNS）收到響應。 注意：某些代理服務(wù)器在DNS查詢超時時會返回400或者500錯誤 |
| 505 | 服務(wù)器不支持，或者拒絕支持在請求中使用的 HTTP 版本。這暗示著服務(wù)器不能或不愿使用與客戶端相同的版本。響應中應當包含一個描述了為何版本不被支持以及服務(wù)器支持哪些協(xié)議的實體。 |
| 506 | 由《透明內(nèi)容協(xié)商協(xié)議》（RFC 2295）擴展，代表服務(wù)器存在內(nèi)部配置錯誤：被請求的協(xié)商變元資源被配置為在透明內(nèi)容協(xié)商中使用自己，因此在一個協(xié)商處理中不是一個合適的重點。 |
| 507 | 服務(wù)器無法存儲完成請求所必須的內(nèi)容。這個狀況被認為是臨時的。WebDAV (RFC 4918) |
| 509 | 服務(wù)器達到帶寬限制。這不是一個官方的狀態(tài)碼，但是仍被廣泛使用。 |
| 510 | 獲取資源所需要的策略并沒有沒滿足。（RFC 2774） |
來源：oschina