HTTP狀態碼參考
瀏覽、搜尋並篩選從 1xx 資訊提示到 5xx 伺服器錯誤的每個 HTTP 狀態碼。每個條目皆包含標準定義、RFC 參考、使用時機、常見陷阱,以及適用於 Express、Django、FastAPI 和 Go net/http 的即貼即用程式碼範例。
偵測到廣告封鎖,導致我們無法顯示廣告
MiniWebtool 依靠廣告收入免費提供服務。如果這個工具幫到你,歡迎升級 Premium(無廣告 + 更快),或將 MiniWebtool.com 加入允許清單後重新整理頁面。
- 或升級 Premium(無廣告)
- 允許 MiniWebtool.com 顯示廣告,然後重新載入
HTTP狀態碼參考
http狀態碼參考是一個完整、可搜尋的索引計算機,涵蓋了 HTTP 規範中定義的每一個狀態碼 — 從 100 Continue 一直到 511 Network Authentication Required。每項條目皆展示了標準名稱、定義它的 RFC 規範、狀態碼的真實含義、何時發送、何時不該發送,以及在實際程式碼庫中經常遇到的常見陷阱。透過即時篩選欄和類別標籤,您只需點擊一下即可在各個類別之間跳轉。
與常見的扁平化速查表不同,此工具為每個狀態碼提供專屬的微型頁面,內含三個採用顏色標記的面板(建議 / 不建議 / 陷阱),以及適用於 Express.js、Django、FastAPI 和 Go net/http 且可直接貼上的處理常式。動畫化的線路圖展示了請求從用戶端到伺服器的傳輸過程,以及所選狀態回傳的流向 — 這對於正在學習狀態碼在網路上實際代表什麼的新手來說非常有用。
為什麼狀態碼參考如此重要
🎯 挑選正確的狀態碼
如果發生錯誤卻回傳 200 並附帶錯誤負載,或是將驗證錯誤回傳 500,會把錯誤混入您的監控系統中,並讓用戶端感到困惑。本工具的建議 / 不建議面板讓標準選擇一目了然。
📚 RFC 規範引用
每個狀態碼皆連結至 RFC 9110、RFC 6585、RFC 4918 或其他定義文件的特定章節。再也不必為 422 究竟是指語法錯誤還是語意錯誤而爭論不休。
🧩 開發框架程式碼片段
提供適用於 Express、Django、FastAPI 和 Go net/http 的正確單行程式碼 — 包括嚴格的用戶端所期望的標頭(如 201 的 Location、429 和 503 的 Retry-After、405 的 Allow)。
如何使用 http狀態碼參考
- 快速查詢。 在頂部的搜尋方塊中輸入狀態碼(
404)或部分名稱(teapot、gateway)並送出。符合的條目將會隨完整的詳細資訊面板一同開啟。 - 依類別瀏覽。 點擊 5 個標籤(1xx、2xx、3xx、4xx、5xx)中的任意一個,即可將卡片列表篩選至該類別。點擊 全部 可重設篩選。
- 即時篩選。 卡片列表正上方的篩選方塊會在您輸入時即時收窄卡片範圍 — 當您只記得部分名稱(如 too many 或 precondition)時非常實用。
- 檢查狀態碼。 點擊任意卡片即可開啟其詳細資訊面板。您將會看到其含義、使用時機、不使用時機、常見陷阱以及 4 種開發框架的程式碼片段區塊。
- 複製程式碼片段。 利用標籤切換器和小巧的 複製 按鈕,即可取得現成可貼上的處理常式。
- 對比相鄰狀態碼。 詳細資訊面板的末尾附有來自同一類別(1xx / 2xx / 3xx / 4xx / 5xx)的相鄰卡片,便於進行快速的並排對比。
五大 HTTP 狀態類別一覽
| 類別 | 含義 | 著名成員 |
|---|---|---|
| 1xx 資訊性 | 暫時性,後續還有更多資訊 | 100 Continue, 101 Switching Protocols, 103 Early Hints |
| 2xx 成功 | 請求已成功處理 | 200 OK, 201 Created, 204 No Content, 206 Partial Content |
| 3xx 重新導向 | 需要採取進一步行動 | 301 Moved Permanently, 302 Found, 304 Not Modified, 308 Permanent Redirect |
| 4xx 用戶端錯誤 | 請求存在錯誤 | 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests |
| 5xx 伺服器錯誤 | 伺服器處理失敗 | 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable, 504 Gateway Timeout |
經常混淆 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 規範保持同步。
引用此內容、頁面或工具為:
"HTTP狀態碼參考" 於 https://MiniWebtool.com/zh-tw//,來自 MiniWebtool,https://MiniWebtool.com/
由 MiniWebtool 團隊製作。更新時間:2026-05-21