HTTP狀態碼參考

http狀態碼參考是一個完整、可搜尋的索引計算機，涵蓋了 HTTP 規範中定義的每一個狀態碼 — 從 100 Continue 一直到 511 Network Authentication Required。每項條目皆展示了標準名稱、定義它的 RFC 規範、狀態碼的真實含義、何時發送、何時不該發送，以及在實際程式碼庫中經常遇到的常見陷阱。透過即時篩選欄和類別標籤，您只需點擊一下即可在各個類別之間跳轉。

與常見的扁平化速查表不同，此工具為每個狀態碼提供專屬的微型頁面，內含三個採用顏色標記的面板（建議 / 不建議 / 陷阱），以及適用於 Express.js、Django、FastAPI 和 Go net/http 且可直接貼上的處理常式。動畫化的線路圖展示了請求從使用者端到伺服器的傳輸過程，以及所選狀態回傳的流向 — 這對於正在學習狀態碼在網路上實際代表什麼的新手來說非常有用。

為什麼狀態碼參考如此重要

如何使用 http狀態碼參考

1. 快速查詢。 在頂部的搜尋方塊中輸入狀態碼（404）或部分名稱（teapot、gateway）並送出。符合的條目將會隨完整的詳細資訊面板一同開啟。
2. 依類別瀏覽。 點擊 5 個標籤（1xx、2xx、3xx、4xx、5xx）中的任意一個，即可將卡片列表篩選至該類別。點擊 全部 可重設篩選。
3. 即時篩選。 卡片列表正上方的篩選方塊會在您輸入時即時收窄卡片範圍 — 當您只記得部分名稱（如 too many 或 precondition）時非常實用。
4. 檢查狀態碼。 點擊任意卡片即可開啟其詳細資訊面板。您將會看到其含義、使用時機、不使用時機、常見陷阱以及 4 種開發框架的程式碼片段區塊。
5. 複製程式碼片段。 利用標籤切換器和小巧的 複製 按鈕，即可取得現成可貼上的處理常式。
6. 對比相鄰狀態碼。 詳細資訊面板的末尾附有來自同一類別（1xx / 2xx / 3xx / 4xx / 5xx）的相鄰卡片，便於進行快速的並排對比。

五大 HTTP 狀態類別一覽

經常混淆 management 的狀態碼組合

• 401 與 403。 401 表示未驗證 — 請求缺乏有效的憑證。403 表示已驗證但無權限 — 憑證本身沒有問題，但該使用者缺乏操作該資源的權限。
• 404 與 410。 404 表示未知：也許它存在於某處，或者只是網址打錯。410 表示刻意移除：搜尋引擎應將其從索引中剔除。
• 301 遇上 302、307、308。 301 / 308 是永久性的（308 嚴格保留請求方法與主體），302 / 307 是暫時性的（307 嚴格保留請求方法與主體）。對於 POST / PUT / PATCH 的重新導向，請使用 307 / 308。
• 400 與 422。 400 表示請求主體格式錯誤（錯誤的 JSON、缺少必填欄位）。422 表示主體已成功解析，但其數值未通過業務規則（無效的電子郵件格式、數量超出範圍）。
• 502、503 與 504。 502 表示上游伺服器傳回了垃圾資料。503 表示伺服器目前過載或正在維護中。504 表示上游伺服器未能在規定時間內做出回應。
• 409 與 412。 409 是與資源當前狀態發生衝突。412 則特指預設條件標頭（If-Match、If-Unmodified-Since）的評估結果為 false。

與特定狀態碼搭配使用的標頭

• 201 Created — 應包含指向新資源的 Location。
• 301 / 302 / 307 / 308 — 必須包含帶有目標 URL 的 Location。
• 304 Not Modified — 必須重複回傳原本在 200 回應中會出現的標頭（ETag、Cache-Control、Vary）。
• 401 Unauthorized — 必須包含 WWW-Authenticate 並列出接受的驗證架構（Basic、Bearer）。
• 405 Method Not Allowed — 必須包含 Allow 並列出允許使用的請求方法。
• 413 / 429 / 503 — 通常包含 Retry-After（秒數或 HTTP 日期格式），以便使用者端正確採取退避機制。
• 416 Range Not Satisfiable — 必須包含 Content-Range: bytes */<length>。

幾乎可以完全忽略的狀態碼

有少數狀態碼雖然在技術上有效，但在現代 API 中極為罕見：305 Use Proxy（已棄用）、306（保留，未使用）、305、506 Variant Also Negotiates、510 Not Extended 以及 508 Loop Detected。大多數代碼是出於歷史原因才保留在登入中。如果您的程式庫或中介軟體發出了其中一個狀態碼，請將其視為該程式庫的錯誤報告 — 而不是提示您去對其進行特殊處理。

常見問題

此工具是否包含 9110 以外的 RFC 狀態碼？

是的。它涵蓋了 RFC 9110（HTTP 語意）、RFC 6585（追加的 4xx / 5xx）、RFC 4918（WebDAV）、RFC 5842（WebDAV 綁定）、RFC 7725（451）、RFC 8297（103 Early Hints）、RFC 8470（425 Too Early），以及著名的趣味規範 RFC 2324（418 Teapot）。

這些狀態碼在 HTTP/2 和 HTTP/3 中有效嗎？

是的。狀態碼語意定義在 RFC 9110 中，這是與版本無關的 HTTP 語意文件。HTTP/2（RFC 9113）和 HTTP/3（RFC 9114）僅改變了訊框處理和傳輸層。

我可以建立直接指向特定狀態碼的連結嗎？

只要在表單中輸入單一狀態碼（例如 404）並送出，詳細資訊面板就會載入至表單下方。網址會顯示您的搜尋內容，可以安全地分享 — 開啟此網址將會載入相同的結果。

為什麼我的開發框架不允許我返回 418？

某些 HTTP 程式庫的舊版本會拒絕發出未包含在其內部登入中的狀態碼。解決方法是升級該程式庫，或在可行情況下手動寫入狀態行。

API 是否應該回傳 200 卻在主體中包含錯誤訊息？

不應該。監控系統、重試機制和中介軟體都預設 2xx 代表成功。如果您必須回傳結構化的錯誤資訊，請回傳適當的 4xx 或 5xx 狀態碼，並將結構化詳細資訊放入回應主體中。針對 HTTP API 的問題詳細資訊格式（RFC 9457）是一個很好的範本。

是否存在 HTTP 狀態碼的官方權威登入表？

是的。IANA 在 iana.org/assignments/http-status-codes 維護官方登入表。本計算機工具會與該登入表以及最常被引用的 RFC 規範保持同步。