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