HTTP 狀態碼對照表

查詢 HTTP 狀態碼代表的意義。

1xx 資訊性
100Continue已收到請求的開頭部分,用戶端應繼續傳送其餘的請求內容。
101Switching Protocols伺服器依照用戶端的要求切換通訊協定,例如升級為 WebSocket。
102Processing伺服器已接受完整的請求,但尚未處理完成(WebDAV)。
103Early Hints讓用戶端在伺服器準備最終回應的同時,就能開始預先載入資源。
2xx 成功
200OK請求成功,回應內容中包含所要求的資源。
201Created請求成功,並因此建立了一個新的資源。
202Accepted請求已被接受處理,但處理作業尚未完成。
203Non-Authoritative Information回傳的中繼資料並非來自原始伺服器,而是第三方或本機快取的副本。
204No Content請求成功,但沒有內容可回傳。
205Reset Content請求成功;用戶端應重設傳送該請求的文件檢視畫面。
206Partial Content僅傳送資源的一部分,對應於位元組範圍請求。
207Multi-Status在可能需要多個狀態碼的情況下,傳達多個資源的相關資訊(WebDAV)。
208Already Reported該 WebDAV 繫結的成員已在回應的先前部分列出過。
226IM Used伺服器已使用一或多個實例操作來完成該請求。
3xx 重新導向
300Multiple Choices該請求有多個可能的回應;用戶端應從中選擇一個。
301Moved Permanently該資源已永久移至回應中提供的新網址。
302Found該資源暫時位於不同的網址;日後的請求仍應使用原始網址。
303See Other可使用 GET 請求在另一個網址找到該回應。
304Not Modified自用戶端快取標頭所指定的版本以來,該資源並未變更。
307Temporary Redirect該資源暫時位於不同的網址;與 302 不同,必須沿用原本的請求方法。
308Permanent Redirect該資源已永久移至新網址;必須沿用原本的請求方法。
4xx 用戶端錯誤
400Bad Request由於語法無效,伺服器無法理解該請求。
401Unauthorized需要進行驗證,但驗證失敗或尚未提供驗證資訊。
402Payment Required保留供未來使用;最初是為數位支付系統所設計。
403Forbidden即使請求可被理解,用戶端仍無權存取該內容。
404Not Found伺服器找不到所要求的資源。
405Method Not Allowed該請求方法是已知的,但目標資源並不支援。
406Not Acceptable伺服器無法產生符合用戶端 Accept 標頭要求的回應。
407Proxy Authentication Required必須先透過代理伺服器完成驗證,該請求才能繼續進行。
408Request Timeout伺服器等待用戶端的請求逾時。
409Conflict該請求與目標資源目前的狀態相衝突。
410Gone所要求的資源已不再可用,且已被永久移除。
411Length Required伺服器需要 Content-Length 標頭,但該請求中缺少此標頭。
412Precondition Failed伺服器未滿足請求標頭中所指定的前提條件。
413Payload Too Large請求內容的大小超過伺服器願意或能夠處理的範圍。
414URI Too Long所要求的 URI 長度超過伺服器願意解析的範圍。
415Unsupported Media Type伺服器不支援該請求的媒體格式。
416Range Not Satisfiable考量到資源的大小,無法滿足所要求的位元組範圍。
417Expectation Failed伺服器無法滿足該請求 Expect 標頭中所指定的期望。
418I'm a TeapotRFC 2324 中作為愚人節玩笑所定義的趣味狀態碼;伺服器不應該煮咖啡。
421Misdirected Request該請求被傳送到一個無法針對目標 URI 產生回應的伺服器。
422Unprocessable Content該請求格式正確,但內含語意錯誤而無法處理。
423Locked正在存取的資源已被鎖定(WebDAV)。
424Failed Dependency該請求因依賴另一個失敗的請求而失敗(WebDAV)。
425Too Early伺服器不願意處理可能被重放(replay)的請求。
426Upgrade Required用戶端應切換至 Upgrade 標頭中所指定的其他通訊協定。
428Precondition Required原始伺服器要求該請求必須是條件式請求。
429Too Many Requests用戶端在一段時間內傳送了過多的請求(速率限制)。
431Request Header Fields Too Large由於標頭欄位過大,伺服器將不會處理該請求。
451Unavailable For Legal Reasons基於法律原因(例如政府要求的審查)而無法使用該資源。
5xx 伺服器錯誤
500Internal Server Error伺服器遇到未預期的狀況,導致無法完成該請求。
501Not Implemented伺服器不支援完成該請求所需的功能。
502Bad Gateway伺服器做為閘道時,從上游伺服器收到了無效的回應。
503Service Unavailable伺服器尚未準備好處理該請求,通常是因為維護或負載過高。
504Gateway Timeout伺服器做為閘道時,未能及時從上游伺服器收到回應。
505HTTP Version Not Supported伺服器不支援該請求所使用的 HTTP 版本。
506Variant Also Negotiates伺服器在內容協商方面存在內部設定錯誤。
507Insufficient Storage伺服器無法儲存完成該請求所需的表示內容(WebDAV)。
508Loop Detected伺服器在處理該請求時偵測到無限迴圈(WebDAV)。
510Not Extended伺服器需要該請求有進一步的擴充才能完成處理。
511Network Authentication Required用戶端需要先通過驗證才能取得網路存取權限,常見於強制網路入口(captive portal)。

使用範例

了解 API 回應狀態碼的意義

搜尋後端 API 回傳的陌生代碼(例如 422),快速了解其意義以及該如何應對。

選擇正確的重新導向代碼

查看 301 與 308、或 302 與 307 之間的差異,以決定移動網址時該使用哪一種重新導向狀態。

查詢在瀏覽器網路分頁中看到的代碼

搜尋您在瀏覽器開發人員工具的網路分頁中看到的狀態碼,以了解請求失敗的原因。

在除錯驗證時區分 401 與 403

並排搜尋「401」與「403」,看出確切的差異:401 代表請求沒有有效的憑證,而 403 代表憑證有效,但使用者不被允許存取該資源。

決定如何在用戶端處理速率限制

查詢 429,確認它代表在特定時間內請求過多,並檢查您的 API 回應是否包含 Retry-After 標頭,重試前應遵守該標頭。

常見問題

這份清單上的代碼真的都是標準代碼嗎?

是的——這份清單只收錄了登記在 IANA 官方 HTTP 狀態碼登錄表中、且常見使用的代碼。不包含非標準或非正式的代碼。

為什麼像 305、306 這樣的代碼沒有列出來?

305(Use Proxy)基於安全考量已實質上被棄用,而 306 則未被使用。由於實際上極不可能遇到這兩個代碼,因此這份清單只聚焦於您真正會遇到的代碼。

這些說明可以取代完整規格或法律建議嗎?

不行——這些只是方便快速查詢的簡短摘要。如果精確的行為很重要,請直接查閱相關的 RFC 或目前的 HTTP 規格文件。

401 與 403 的真正差別是什麼?

401 Unauthorized 實際上是指「未經驗證」——伺服器不知道您是誰,通常是因為缺少憑證或憑證無效。403 Forbidden 則是指伺服器知道您是誰,但即使憑證有效,您也沒有存取該資源的權限。

資源不存在時,應該使用 404 還是 410?

當資源不存在,而您不知道(或不想說明)它是否曾經存在時,請使用 404 Not Found。當您確定資源曾經存在但已被永久移除時,請使用 410 Gone——它會告知用戶端與搜尋引擎停止再請求它。

重新導向時,何時該使用 301、302、307 或 308?

301 與 308 是永久重新導向;302 與 307 是暫時重新導向。較舊的一組(301/302)與較新的一組(307/308)的差別在於,307 與 308 保證在重新導向後的請求中保留請求方法與本文,而 301 與 302 在歷史上允許用戶端將 POST 改為 GET。

為什麼我的伺服器回傳 500,而不是更明確的代碼?

500 Internal Server Error 是針對非預期的伺服器端失敗(例如未處理的例外)的通用統稱。這通常代表伺服器的錯誤處理沒有將該失敗對應到更明確的 4xx 或 5xx 代碼——請檢查伺服器記錄以找出真正的原因。