HTTP狀態碼

HTTP狀態碼（HTTP Status Code）是用以表示網頁伺服器超文本傳輸協議響應狀態的3位數字代碼，附帶可選的英文消息短語。它由 RFC 2616 規範定義的，並得到 RFC 2518、RFC 2817、RFC 2295、RFC 2774 與 RFC 4918 等規範擴展。除非另有說明，狀態碼是 HTTP 標準（RFC 7231）的一部分。

HTTP狀態碼的官方註冊表由網際網路號碼分配局（Internet Assigned Numbers Authority）維護。

所有HTTP響應狀態代碼分為五類。狀態代碼的第一位數字定義了響應的類別，而後兩位數字沒有分類作用。標準定義了五個類別：

- 1xx 資訊響應 – 請求已接收，正在繼續處理
- 2xx 成功 – 請求已成功接收、理解並接受
- 3xx 重定向 – 需要採取進一步的措施以完成請求
- 4xx 客戶端錯誤 – 請求包含語法錯誤或無法完成
- 5xx 伺服器錯誤 – 伺服器未能完成明顯有效的請求

## 1xx消息

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

這些狀態碼代表的響應都用來顯示資訊，標示客戶應該等待伺服器採取進一步行動。

100 Continue：伺服器已經接收到請求頭，並且客戶端應繼續發送請求主體（在需要發送身體的請求的情況下：例如，POST請求），或者如果請求已經完成，忽略這個響應。伺服器必須在請求完成後向客戶端發送一個最終響應。要使伺服器檢查請求的頭部，客戶端必須在其初始請求中發送`Expect: 100-continue`作為頭部，並在發送正文之前接收`100 Continue`狀態代碼。響應代碼`417 Expectation Failed`表示請求不應繼續。

101 Switching Protocols：伺服器已經理解了客戶端的請求，並將通過Upgrade消息頭通知客戶端採用不同的協議來完成這個請求。在發送完這個響應最後的空行後，伺服器將會切換到在Upgrade消息頭中定義的那些協議。

只有在切換到更好的新協議時才應該採用此代碼。例如，切換到新的HTTP版本（如HTTP/2）比舊版本更有優勢，或者切換到一個實時且同步的協議（如WebSocket）以傳送利用此類特性的資源。

已棄用：102 Processing（WebDAV；RFC 2518）：WebDAV請求可能包含許多涉及文件操作的子請求，需要很長時間才能完成請求。該代碼表示伺服器已經收到並正在處理請求，但無響應可用。這樣可以防止客戶端超時並假設請求丟失。

103 Early Hints (RFC 8297)：用來在最終的HTTP消息之前返回一些響應頭。

## 2xx成功

這一類型的狀態碼代表伺服器收到、理解、接受了請求。

200 OK：HTTP 請求成功的標準響應。實際的響應將取決於所使用的請求方法。在GET請求中，響應將包含與請求的資源相對應的實體。在POST請求中，響應將包含描述或操作結果的實體。

201 Created：請求已經被實現，而且有一個新的資源已經依據請求的需要而建立，且其URI已經隨Location頭資訊返回。假如需要的資源無法及時建立的話，應當返回'202 Accepted'。

202 Accepted：伺服器已接受請求，但尚未處理。最終該請求可能會也可能不會被執行，並且可能在處理發生時被禁止。

203 Non-Authoritative Information（自HTTP / 1.1起）：伺服器是一個轉換代理伺服器（transforming proxy，例如網路加速器），以`200 OK`狀態碼為起源，但回應了原始響應的修改版本。

204 No Content：伺服器成功處理了請求，沒有返回任何內容。在強制門戶功能中，Wi-Fi 設備連接到需要進行 Web 認證的 Wi-Fi 接入點時，通過訪問一個能生成 HTTP 204 響應的網站，如果能正常收到 204 響應，則代表無需 Web 認證，否則會彈出網頁瀏覽器界面，顯示出 Web 網頁認證界面用於讓使用者認證登錄。

205 Reset Content：伺服器成功處理了請求，但沒有返回任何內容。與204響應不同，此響應要求請求者重置文檔視圖。

206 Partial Content（RFC 7233）：伺服器已經成功處理了部分GET請求。類似於FlashGet或者迅雷這類的HTTP都是使用此類響應實現斷點續傳或者將一個大文檔分解為多個下載段同時下載。

207 Multi-Status（WebDAV；RFC 4918）：代表之後的消息體將是一個XML消息，並且可能依照之前子請求數量的不同，包含一系列獨立的響應代碼。

208 Already Reported （WebDAV；RFC 5842）：DAV綁定的成員已經在（多狀態）響應之前的部分被列舉，且未被再次包含。

226 IM Used （RFC 3229）：伺服器已經滿足了對資源的請求，對實體請求的一個或多個實體操作的結果表示。

## 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：要求客戶端執行臨時重定向（原始描述短語為「Moved Temporarily」）。由於這樣的重定向是臨時的，客戶端應當繼續向原有地址發送以後的請求。只有在Cache-Control或Expires中進行了指定的情況下，這個響應才是可緩存的。

新的臨時性的URI應當在響應的Location域中返回。除非這是一個HEAD請求，否則響應的實體中應當包含指向新的URI的超連結及簡短說明。

如果這不是一個GET或者HEAD請求，那麼瀏覽器禁止自動進行重定向，除非得到使用者的確認，因為請求的條件可能因此發生變化。

注意：雖然RFC 1945和RFC 2068規範不允許客戶端在重定向時改變請求的方法，但是很多現存的瀏覽器將302響應視作為303響應，並且使用GET方式訪問在Location中規定的URI，而無視原先請求的方法。因此狀態碼303和307被添加了進來，用以明確伺服器期待客戶端進行何種反應。

303 See Other：對應當前請求的響應可以在另一個URI上被找到，當響應於POST（或PUT / DELETE）接收到響應時，客戶端應該假定伺服器已經收到數據，並且應該使用單獨的GET消息發出重定向。這個方法的存在主要是為了允許由腳本激活的POST請求輸出重定向到一個新的資源。這個新的URI不是原始資源的替代引用。同時，303響應禁止被緩存。當然，第二個請求（重定向）可能被緩存。

新的URI應當在響應的Location域中返回。除非這是一個HEAD請求，否則響應的實體中應當包含指向新的URI的超連結及簡短說明。

注意：許多HTTP/1.1版以前的瀏覽器不能正確理解303狀態。如果需要考慮與這些瀏覽器之間的互動，302狀態碼應該可以勝任，因為大多數的瀏覽器處理302響應時的方式恰恰就是上述規範要求客戶端處理303響應時應當做的。

304 Not Modified：表示資源在由請求頭中的If-Modified-Since或If-None-Match參數指定的這一版本之後，未曾被修改。在這種情況下，由於客戶端仍然具有以前下載的副本，因此不需要重新傳輸資源。

305 Use Proxy：被請求的資源必須通過指定的代理才能被訪問。Location域中將給出指定的代理所在的URI資訊，接收者需要重複發送一個單獨的請求，通過這個代理才能訪問相應資源。只有原始伺服器才能建立305響應。許多HTTP客戶端（像是Mozilla）都沒有正確處理這種狀態代碼的響應，主要是出於安全考慮。

注意：RFC 2068中沒有明確305響應是為了重定向一個單獨的請求，而且只能被原始伺服器建立。忽視這些限制可能導致嚴重的安全後果。

306 Switch Proxy：在最新版的規範中，306狀態碼已經不再被使用。最初是指「後續請求應使用指定的代理」。

307 Temporary Redirect：在這種情況下，請求應該與另一個URI重複，但後續的請求應仍使用原始的URI。與302相反，當重新發出原始請求時，不允許更改請求方法。例如，應該使用另一個POST請求來重複POST請求。

308 Permanent Redirect (RFC 7538)：請求和所有將來的請求應該使用另一個URI重複。307和308重複302和301的行為，但不允許HTTP方法更改。例如，將表單提交給永久重定向的資源可能會順利進行。

## 4xx客戶端錯誤

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

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

400 Bad Request：由於明顯的客戶端錯誤（例如，格式錯誤的請求語法，太大的大小，無效的請求消息或欺騙性路由請求），伺服器不能或不會處理該請求。

401 Unauthorized（RFC 7235）：類似於403 Forbidden，401語義即「未認證」，即使用者沒有必要的憑據。該狀態碼表示當前請求需要使用者驗證。該響應必須包含一個適用於被請求資源的WWW-Authenticate資訊頭用以詢問使用者資訊。客戶端可以重複提交一個包含恰當的Authorization頭資訊的請求。如果當前請求已經包含了Authorization證書，那麼401響應代表著伺服器驗證已經拒絕了那些證書。如果401響應包含了與前一個響應相同的身份驗證詢問，且瀏覽器已經至少嘗試了一次驗證，那麼瀏覽器應當向使用者展示響應中包含的實體資訊，因為這個實體資訊中可能包含了相關診斷資訊。

注意：當網站（通常是網站域名）禁止IP位址時，有些網站狀態碼顯示的401，表示該特定地址被拒絕訪問網站。

402 Payment Required：該狀態碼是為了將來可能的需求而預留的。該狀態碼最初的意圖可能被用作某種形式的數字現金或在線支付方案的一部分，但幾乎沒有哪家服務商使用，而且這個狀態碼通常不被使用。如果特定開發人員已超過請求的每日限制，Google Developers API會使用此狀態碼。

403 Forbidden：伺服器已經理解請求，但是拒絕執行它。與401響應不同的是，身份驗證並不能提供任何幫助，而且這個請求也不應該被重複提交。如果這不是一個HEAD請求，而且伺服器希望能夠講清楚為何請求不能被執行，那麼就應該在實體內描述拒絕的原因。當然伺服器也可以返回一個404響應，假如它不希望讓客戶端獲得任何資訊。

404 Not Found：請求失敗，請求所希望得到的資源未被在伺服器上發現，但允許用戶的後續請求。沒有資訊能夠告訴使用者這個狀況到底是暫時的還是永久的。假如伺服器知道情況的話，應當使用410狀態碼來告知舊資源因為某些內部的配置機制問題，已經永久的不可用，而且沒有任何可以跳轉的地址。404這個狀態碼被廣泛應用於當伺服器不想揭示到底為何請求被拒絕或者沒有其他適合的響應可用的情況下。

405 Method Not Allowed：請求行中指定的請求方法不能被用於請求相應的資源。該響應必須返回一個Allow頭資訊用以表示出當前資源能夠接受的請求方法的列表。例如，需要通過POST呈現數據的表單上的GET請求，或只讀資源上的PUT請求。

鑑於PUT，DELETE方法會對伺服器上的資源進行寫操作，因而絕大部分的網頁伺服器都不支持或者在默認配置下不允許上述請求方法，對於此類請求均會返回405錯誤。

406 Not Acceptable：請求的資源的內容特性無法滿足請求頭中的條件，因而無法生成響應實體，該請求不可接受。

除非這是一個HEAD請求，否則該響應就應當返回一個包含可以讓使用者或者瀏覽器從中選擇最合適的實體特性以及地址列表的實體。實體的格式由Content-Type頭中定義的媒體類型決定。瀏覽器可以根據格式及自身能力自行作出最佳選擇。但是，規範中並沒有定義任何作出此類自動選擇的標準。

407 Proxy Authentication Required（RFC 2617）：與401響應類似，只不過客戶端必須在代理伺服器上進行身份驗證。代理伺服器必須返回一個Proxy-Authenticate用以進行身份詢問。客戶端可以返回一個Proxy-Authorization資訊頭用以驗證。

408 Request Timeout：請求超時。根據HTTP規範，客戶端沒有在伺服器預備等待的時間內完成一個請求的發送，客戶端可以隨時再次提交這一請求而無需進行任何更改。

409 Conflict：表示因為請求存在衝突無法處理該請求，例如多個同步更新之間的編輯衝突。

410 Gone：表示所請求的資源不再可用。當資源被有意地刪除並且資源應被清除時，應該使用這個。在收到410狀態碼後，使用者應停止再次請求資源。但大多數服務端不會使用此狀態碼，而是直接使用404狀態碼。

411 Length Required：伺服器拒絕在沒有定義Content-Length頭的情況下接受請求。在添加了表明請求消息體長度的有效Content-Length頭之後，客戶端可以再次提交該請求。

412 Precondition Failed（RFC 7232）：伺服器在驗證在請求的頭欄位中給出先決條件時，沒能滿足其中的一個或多個。這個狀態碼允許客戶端在獲取資源時在請求的元資訊（請求頭欄位數據）中設置先決條件，以此避免該請求方法被應用到其希望的內容以外的資源上。

413 Request Entity Too Large（RFC 7231）：前稱「Request Entity Too Large」，表示伺服器拒絕處理當前請求，因為該請求提交的實體數據大小超過了伺服器願意或者能夠處理的範圍。此種情況下，伺服器可以關閉連接以免客戶端繼續發送此請求。

如果這個狀況是臨時的，伺服器應當返回一個Retry-After的響應頭，以告知客戶端可以在多少時間以後重新嘗試。

414 Request-URI Too Long（RFC 7231）：前稱「Request-URI Too Long」，表示請求的URI長度超過了伺服器能夠解釋的長度，因此伺服器拒絕對該請求提供服務。通常將太多數據的結果編碼為GET請求的查詢字符串，在這種情況下，應將其轉換為POST請求。這比較少見，通常的情況包括：

- 本應使用POST方法的表單提交變成了GET方法，導致查詢字符串過長。
- 重定向URI「黑洞」，例如每次重定向把舊的URI作為新的URI的一部分，導致在若干次重定向後URI超長。
- 客戶端正在嘗試利用某些伺服器中存在的安全漏洞攻擊伺服器。這類伺服器使用固定長度的緩衝讀取或操作請求的URI，當GET後的參數超過某個數值後，可能會產生緩衝區溢出，導致任意代碼被執行。沒有此類漏洞的伺服器，應當返回414狀態碼。

415 Unsupported Media Type：對於當前請求的方法和所請求的資源，請求中提交的網際網路媒體類型並不是伺服器中所支持的格式，因此請求被拒絕。例如，客戶端將圖像上傳格式為svg，但伺服器要求圖像使用上傳格式為jpg。

416 Requested Range Not Satisfiable（RFC 7233）：前稱「Requested Range Not Satisfiable」。客戶端已經要求文件的一部分（Byte serving），但伺服器不能提供該部分。例如，如果客戶端要求文件的一部分超出文件尾端。

417 Expectation Failed：在請求頭Expect中指定的預期內容無法被伺服器滿足，或者這個伺服器是一個代理服顯的證據證明在當前路由的下一個節點上，Expect的內容無法被滿足。

418 I'm a teapot（RFC 2324， httpwg/http-core#43，RFC 9110）：本操作碼是在1998年作為IETF的傳統愚人節笑話, 在RFC 2324超文本咖啡壺控制協議中定義的，並不需要在真實的HTTP伺服器中定義，同時也不是規範的HTTP狀態碼。當一個控制茶壺的HTCPCP收到BREW或POST指令要求其煮咖啡時應當回傳此錯誤。這個HTTP狀態碼在某些網站（包括Google.com）與項目（如Node.js、ASP.NET和Go語言）中用作彩蛋。現時在IANA HTTP 狀態碼註冊表中此狀態碼處於「保留，但如果4XX耗盡則可以被重新分配」的狀態。

421 Misdirected Request （RFC 7540）：該請求針對的是無法產生響應的伺服器（例如因為連接重用）。

422 Unprocessable Entity（WebDAV；RFC 4918）：請求格式正確，但是由於含有語義錯誤，無法響應。

423 Locked（WebDAV；RFC 4918）：當前資源被鎖定。

424 Failed Dependency（WebDAV；RFC 4918）：由於之前的某個請求發生的錯誤，導致當前請求失敗，例如PROPPATCH。

425 Too Early (RFC 8470)：伺服器拒絕處理在Early Data中的請求，以規避可能的重放攻擊。

426 Upgrade Required（RFC 2817）：客戶端應切換到Upgrade頭欄位中給出的不同協議，如TLS/1.0。

428 Precondition Required (RFC 6585)：原伺服器要求該請求滿足一定條件。這是為了防止「未更新」問題，即客戶端讀取（GET）一個資源的狀態，更改它，並將它寫（PUT）回伺服器，但這期間第三方已經在伺服器上更改了該資源的狀態，因此導致了衝突。」

429 Too Many Requests （RFC 6585）：使用者在給定的時間內發送了太多的請求。旨在用於網路限速。

431 Request Header Fields Too Large （RFC 6585）：伺服器不願處理請求，因為一個或多個頭欄位過大。

440 Login Time-out：客戶端session逾時失效，需要重新登入。

451 Unavailable For Legal Reasons：該訪問因法律的要求而被拒絕，由IETF在2015核准後新增加。

## 5xx伺服器錯誤

表示伺服器無法完成明顯有效的請求。這類狀態碼代表了伺服器在處理請求的過程中有錯誤或者異常狀態發生，也有可能是伺服器意識到以當前的軟硬體資源無法完成對請求的處理。除非這是一個HEAD請求，否則伺服器應當包含一個解釋當前錯誤狀態以及這個狀況是臨時的還是永久的解釋資訊實體。瀏覽器應當向使用者展示任何在當前響應中被包含的實體。這些狀態碼適用於任何響應方法。

500 Internal Server Error：通用錯誤消息，伺服器遇到了一個未曾預料的狀況，導致了它無法完成對請求的處理。沒有給出具體錯誤信息。

501 Not Implemented：伺服器不支持當前請求所需要的某個功能。當伺服器無法識別請求的方法，並且無法支持其對任何資源的請求。（例如，網路服務API的新功能）

502 Bad Gateway：作為網關或者代理工作的伺服器嘗試執行請求時，從上游伺服器接收到無效的響應。

503 Service Unavailable：由於臨時的伺服器維護或者過載，伺服器當前無法處理請求。這個狀況是暫時的，並且將在一段時間以後恢復。如果能夠預計延遲時間，那麼響應中可以包含一個Retry-After頭用以標明這個延遲時間。如果沒有給出這個Retry-After資訊，那麼客戶端應當以處理500響應的方式處理它。

504 Gateway Timeout：作為網關或者代理工作的伺服器嘗試執行請求時，未能及時從上游伺服器（URI標識出的伺服器，例如HTTP、FTP、LDAP）或者輔助伺服器（例如DNS）收到響應。

注意：某些代理伺服器在DNS查詢超時時會返回400或者500錯誤。

505 HTTP Version Not Supported：伺服器不支持，或者拒絕支持在請求中使用的HTTP版本。這暗示著伺服器不能或不願使用與客戶端相同的版本。響應中應當包含一個描述了為何版本不被支持以及伺服器支持哪些協議的實體。

506 Variant Also Negotiates（RFC 2295）：由《透明內容協商協議》（RFC 2295）擴展，代表伺服器存在內部配置錯誤，被請求的協商變元資源被配置為在透明內容協商中使用自己，因此在一個協商處理中不是一個合適的重點。

507 Insufficient Storage（WebDAV；RFC 4918）：伺服器無法存儲完成請求所必須的內容。這個狀況被認為是臨時的。

508 Loop Detected （WebDAV；RFC 5842）：伺服器在處理請求時陷入死循環。（可代替 208狀態碼）

510 Not Extended（RFC 2774）：獲取資源所需要的策略並沒有被滿足。

511 Network Authentication Required （RFC 6585）：客戶端需要進行身份驗證才能獲得網路訪問權限，旨在限制使用者群訪問特定網路。（例如連接WiFi熱點時的強制網路門戶）

## 非官方狀態碼

420 Enhance Your Calm：Twitter Search與Trends API在客戶端被限速的情況下返回。

444 No Response：Nginx上HTTP伺服器擴展。伺服器不向客戶端返回任何資訊，並關閉連接（有助於阻止惡意軟體）。

450 Blocked by Windows Parental Controls：這是一個由Windows家庭控制（Microsoft）HTTP阻止的450狀態代碼的示例，用於資訊和測試。

494 Request Header Too Large：在錯誤代碼431提出之前Nginx上使用的擴展HTTP代碼。

### IIS

微軟網際網路資訊服務 （Microsoft Internet Information Services）有時會使用額外的十進位子代碼來獲取更多具體資訊，但是這些子代碼僅出現在響應有效內容和文檔中，而不是代替實際的HTTP狀態代碼。

## 外部連結

- Hypertext Transfer Protocol (HTTP) Status Code Registry
- 微軟知識庫：MSKB943891: IIS 7.0、IIS 7.5 和 IIS 8.0 中的 HTTP 狀態代碼
- httpstatus – 檢查網址重定向路徑、請求標頭與 HTTP 狀態代碼