HTTP 狀態程式碼參考
簡而言之: 日常開發中重要的所有狀態程式碼——每個程式碼的含義、使用時機,以及陷阱(401 vs 403、302 vs 307)——可在您輸入時篩選。
🔒 按設計保證隱私: 一切都在此裝置上的您的瀏覽器中執行。您的輸入從不上傳到伺服器。
| 程式碼 | 名稱 | 含義 |
|---|---|---|
| 100 | 繼續 | 客戶端應繼續傳送請求正文 |
| 101 | 切換協議 | 協議升級被接受(例如升級到 WebSocket) |
| 200 | OK | 請求成功——預設的成功響應 |
| 201 | 已建立 | 已建立一個新資源(典型的 POST 成功) |
| 202 | 已接受 | 已排隊進行非同步處理,尚未完成 |
| 204 | 無內容 | 成功,正文故意為空 |
| 301 | 永久移動 | 資源有了一個新的永久 URL——更新連結;SEO 權益會轉移 |
| 302 | 已找到 | 臨時重定向(歷史上被濫用;見 303/307) |
| 303 | 檢視其他 | 重定向到另一個 URL 的 GET(post/redirect/get) |
| 304 | 未修改 | 快取副本仍然有效——透過 ETag/Last-Modified 重新驗證 |
| 307 | 臨時重定向 | 保留方法和正文的臨時重定向 |
| 308 | 永久重定向 | 保留方法和正文的永久重定向 |
| 400 | 請求錯誤 | 伺服器無法解析/理解請求 |
| 401 | 未授權 | 需要身份驗證或驗證失敗(儘管名字如此,它的意思是未透過身份驗證) |
| 403 | 禁止訪問 | 無論是否透過身份驗證,訪問都被拒絕 |
| 404 | 未找到 | 此 URL 沒有資源 |
| 405 | 方法不允許 | 此資源不支援該 HTTP 方法 |
| 406 | 不可接受 | 沒有表示與 Accept 標頭匹配 |
| 408 | 請求超時 | 客戶端傳送請求耗時過長 |
| 409 | 衝突 | 狀態衝突,例如編輯衝突或重複建立 |
| 410 | 已消失(Gone) | 永久刪除(比 404 更強——故意使用) |
| 411 | 需要長度(Length Required) | 需要 Content-Length 標頭 |
| 413 | 內容過大 | 請求正文超過伺服器限制 |
| 414 | URI 過長 | URL 超過伺服器限制 |
| 415 | 不支援的媒體型別 | 請求的 Content-Type 不受支援 |
| 418 | 我是一個茶壺(I'm a Teapot) | RFC 2324 玩笑程式碼,偶爾用於拒絕煮咖啡 |
| 422 | 不可處理的內容 | 語法沒問題,但語義未透過驗證(API 特別喜歡這個) |
| 425 | 過早 | 伺服器不願意處理可能被重放的請求 |
| 429 | 請求過多 | 觸發速率限制——退避,遵守 Retry-After |
| 500 | 內部伺服器錯誤 | 通用伺服器端故障 |
| 501 | 未實現 | 伺服器不支援該功能 |
| 502 | 閘道器錯誤 | 代理/閘道器從上游收到了無效響應 |
| 503 | 服務不可用 | 過載或停機維護——通常是暫時的,可能攜帶 Retry-After |
| 504 | 閘道器超時 | 代理/閘道器等待上游時超時 |
| 505 | 不支援 HTTP 版本 | 請求中的 HTTP 版本不受支援 |
關於
狀態碼是伺服器對每個響應的單數字摘要,按類別分組:1xx 資訊性、2xx 成功、3xx 重定向、4xx 客戶端出錯、5xx 伺服器出錯。表格給出在職開發者實際遇到的程式碼,帶在實踐中重要的細微差別——401 儘管名字如此,含義是未認證;403 是拒絕,與登入無關;422 是 API 驗證失敗;429 要求退避。未列出的程式碼(1xx 和實驗性程式碼的長尾)足夠罕見,僅類別就告訴您如何處理它們。
常見問題
401 和 403 有什麼區別?
401:我們不知道您是誰(請進行身份驗證)。403:我們知道您是誰,但您仍然無權訪問。
臨時重定向用 302 還是 307?
307 會保留請求方法和正文;302 在歷史上允許客戶端把 POST 切換為 GET。新專案應使用 307(永久重定向則用 308)。