免費HTTP 狀態碼參考

用於 Expect: 100-continue 請求。伺服器確認願意在客戶端傳送正文前接收。在現代網路應用中很少見。

最常用於 WebSocket 升級 — 客戶端請求 Upgrade: websocket，伺服器回應 101 進行切換。

WebDAV 中間回應，用於在冗長操作期間防止客戶端超時。已棄用 — 現代伺服器不應傳送。

讓伺服器在準備最終回應期間傳送連結頭 (預載入/預連線)，以便瀏覽器可以更快地開始取得關鍵資源。

標準成功回應。具體含義取決於 HTTP 方法：GET → 返回資源，POST/PUT → 操作完成。

常見於 POST 後。回應應包含指向新資源 URL 的 Location 頭。

用於非同步操作 — 伺服器正在排隊處理。客戶端應輪詢狀態端點或稍後重新檢查。

請求成功，但中介 (如快取或轉換代理) 改變了來自原始伺服器的有效負載 — 例如重新壓縮圖片。在實踐中很少見。

通常用於 DELETE 操作或不需要返回正文的 PUT 更新。客戶端不應離開當前頁面。

類似於 204，不返回正文 — 但另外告知客戶端重設產生請求的表單或檢視 (例如清空表單欄位以供下一條輸入)。

對 Range 請求的回應。由影片播放器和下載管理器使用，用於恢復中斷的下載或流式傳輸大檔案。

WebDAV：XML 正文獨立報告多個子操作的結果 — 例如批次移動，其中某些項成功，其他項失敗。

WebDAV：在 207 多狀態回應內使用，以避免在繫結建立迴圈時重複列出同一集合的成員。

增量編碼：伺服器返回與以前版本的差異，而不是完整資源，節省頻寬。極少實現。

伺服器提供多個選項 (例如不同的格式或語言)，客戶端應選擇一個。很少使用，因為自動內容協商通常處理這個。

用於永久 URL 更改 — 搜尋引擎將更新其索引。SEO 權重轉移到新 URL。

表示重新導向不是永久的。快取不如 301 那樣激進。用於諸如 '需要登入，重新導向到 /login' 之類的事情。

在 POST 提交後使用 — 回應表示 '您的 POST 成功了，請檢視此 GET URL 以取得結果'。瀏覽器始終 GET 新 URL。

對條件請求 (帶有 If-None-Match 或 If-Modified-Since 頭) 的回應。節省頻寬 — 不返回正文。

如果原始請求是 POST，重新導向也使用 POST。當方法保留重要時，307 是 302 的現代替代方案。

301 的現代替代方案，適用於希望 POST 請求在重新導向後仍保持為 POST 的情況。

常見原因：正文中的 JSON 格式錯誤、無效的查詢引數或缺少必需欄位。檢查請求正文和頭。

客戶端必須包含身份驗證憑據 (Authorization 頭、Cookie、令牌)。'Unauthorized' 是用詞不當 — 它實際上意味著 '未認證'。

最初用於數字支付。現代用法：當使用者超過其付費配額時，API 有時會返回 402。

與 401 不同 — 使用者已登入，但其帳戶沒有此資源的權限。檢查角色/權限邏輯。

URL 錯誤、資源已刪除或從未存在。伺服器有時會返回 404 來隱藏 403 更準確的事實。

例如，對僅接受 POST 的端點的 GET 請求。回應應包含列出有效方法的 Allow 頭。

客戶端要求伺服器無法滿足的內容型別、語言或編碼 (透過 Accept、Accept-Language、Accept-Encoding)。許多伺服器跳過嚴格協商並返回預設值。

類似於 401，但由代理發出：客戶端必須傳送代理授權憑據。在具有身份驗證代理的企業網路上很常見。

客戶端傳送請求體用時過長或保持連線空閒狀態。請重試請求。

通常返回於併發編輯衝突或重複資源建立（例如，使用已存在的電子郵件建立使用者）。

比 404 更強 — 伺服器明確知道資源曾經存在但已被永久刪除。搜尋引擎會將其從索引中移除。

請求被拒絕，因為缺少 Content-Length 標頭，伺服器拒絕接收大小未知的請求體。請新增標頭並重試。

在條件標頭（如 If-Match 或 If-Unmodified-Since）驗證失敗時返回 — 通常為樂觀鎖定：自你的版本以來，其他人更改了資源。請重新取得並重試。

上傳大檔案時常見。伺服器設定（nginx、apache）設定了最大請求體大小。請檢查伺服器設定。

通常由非常長的查詢字串引起（例如在 GET 中編碼資料）。改用 POST 請求體，或者如果你可以控制伺服器，提高伺服器限制。

例如，向僅接受 application/json 的伺服器傳送 application/xml。請正確設定 Content-Type 標頭。

Range 標頭要求檔案不具有的部分 — 例如，恢復下載超過檔案末尾。回應應包含具有實際大小的 Content-Range。

在伺服器不支援 Expect: 100-continue 時傳送。某些客戶端在大型 POST 上預設傳送此標頭；停用它通常會解決錯誤。

1998 年的愚人節笑話（RFC 2324）。某些真實 API 用它來開玩笑或標記已棄用的端點。不用於生產。

常見於 HTTP/2 連線重用：請求到達未為目標主機名設定的伺服器。客戶端應在新連線上重試。

例如，JSON 解析正確但缺少必需欄位，或欄位值超出範圍。在 REST API 驗證回應中常見。

WebDAV：源或目標資源被另一個客戶端鎖定，因此操作無法進行。等待鎖釋放或使用正確的令牌中斷它。

WebDAV：在一系列相關操作中，較早的操作失敗，因此此操作未執行。檢視較早的失敗以找到根本原因。

與 TLS 1.3 0-RTT（早期資料）相關：伺服器將不會冒可能重放請求的風險。客戶端應在握手完成後重試。

伺服器拒絕在當前協議上服務請求，但在升級後會 — 回應包含命名所需協議的 Upgrade 標頭。

伺服器要求條件標頭（如 If-Match）以防止丟失更新衝突。取得資源、捕獲其 ETag，並使用 If-Match 重新傳送。

放慢速度。回應應包含 Retry-After 標頭，指示何時重試。常見於具有請求配額的 API。

單個標頭或總標頭大小超過限制 — 最常由過大的 cookies 引起。清除 cookies 或減少應用在其中儲存的內容。

資源因法律原因被阻止 — 審查、法庭命令或地區法規。這個數字是對小說《華氏 451 度》的致敬。

伺服器端錯誤的通用包羅永珍。檢查伺服器日誌以找到實際原因：未處理的異常、資料庫錯誤等。

例如，伺服器不識別 HTTP 方法。實際上很少見 — 更常見的是看到 405。

在微服務架構中常見。你的負載均衡器或反向代理從後端服務獲得了格式錯誤的回應。

要麼正在維護，要麼過載。回應應包含 Retry-After 標頭。通常在部署期間返回。

後端服務回應速度不夠快。檢查上游服務健康狀況和超時設定。

請求的 HTTP 主要版本不受伺服器支援。在現代客戶端中幾乎從不出現。

透明內容協商陷入迴圈：所選變體本身設定為協商。表示伺服器設定錯誤。

WebDAV 特有，但有時由常規伺服器使用。意味著伺服器由於儲存限制而無法儲存請求。

WebDAV：處理 Depth: infinity 請求時進入迴圈（例如迴圈繫結）。操作已終止。

來自已過時的 HTTP 擴充功能框架：伺服器在滿足請求之前需要更多資訊。實際上在現代網路上未使用。

被強制網路門戶（酒店/機場 WiFi）使用，表示使用者必須先登入網路，然後才能存取外部網站。