實用指南

HTTP 狀態碼 — 使用指南與技術原理

HTTP 狀態碼參考工具

開啟工具

概覽

HTTP狀態碼在客戶端和伺服器之間傳達Web請求的結果。對於Web開發、API設計和調試網路通訊至關重要。

核心概念

什麼是 HTTP 狀態碼

HTTP 狀態碼是伺服器返回的三位數字,用於表示 HTTP 請求的處理結果。根據 RFC 7231 標準定義,狀態碼分為五大類:1xx(資訊性響應)、2xx(成功)、3xx(重新導向)、4xx(用戶端錯誤)、5xx(伺服器錯誤)。每個狀態碼都提供關於請求處理結果的特定資訊。

請求-響應機制

當用戶端向伺服器發送 HTTP 請求時,伺服器處理請求後會在響應標頭中返回狀態碼。狀態行格式為:HTTP/1.1 200 確定。用戶端應用程式根據狀態碼決定下一步操作:遇到 5xx 錯誤時重試、收到 3xx 時進行重新導向、處理 401/403 進行身份驗證等。

狀態碼分類詳解

1xx 表示正在處理中(100 Continue、101 Switching Protocols)。2xx 表示操作成功(200 確定、201 Created、204 否 內容)。3xx 要求用戶端重新導向(301 永久移動、302 臨時重新導向、304 未修改)。4xx 表示用戶端錯誤(400 錯誤請求、401 未授權、404 未找到)。5xx 表示伺服器故障(500 內部錯誤、502 閘道錯誤、503 服務不可用)。

RESTful API 設計應用

在 RESTful API 設計中,正確使用狀態碼至關重要。發布 請求建立資源應返回 201,放置/PATCH 更新資源返回 200 或 204,刪除 刪除成功返回 204。使用 400 表示驗證錯誤,401 表示缺少身份驗證,403 表示權限不足,409 表示衝突。這種標準化提高了 API 的可用性和用戶端錯誤處理能力。

功能特色

完整的狀態碼庫

全面的 HTTP 狀態碼參考,涵蓋 1xx 到 5xx 所有標準狀態碼,包含每個狀態碼的詳細描述、含義和使用場景

智能搜尋與過濾

透過編號、名稱或描述快速查找狀態碼。按類別(資訊性、成功、重新導向、用戶端錯誤、伺服器錯誤)過濾,即刻定位相關狀態碼

分類組織展示

按照 RFC 7231 標準分類組織狀態碼,使用彩色標籤區分,一目了然地理解每個響應的性質

詳細使用指導

每個狀態碼都包含實際範例、常見用例和最佳實踐,幫助您在 REST API 和 Web 應用中正確實現

常見問題

為何 HTTP 狀態碼對開發者重要?

它是客戶端與伺服器之間的契約。正確的狀態碼能決定是否要重試、要求登入、跟隨重新導向或顯示友善錯誤,也有助於記錄與監控。

4xx 與 5xx 差在哪?

4xx 表示請求有誤(400、401、404 等),通常需由客戶端修正;5xx 表示伺服器在處理合法請求時失敗(500、502、503),需由伺服端排查。

何時使用 301/302/307/308?

301/308 為永久導向,302/307 為暫時。301/302 可能將方法改為 取得,307/308 會保持原方法與 body。若要永久導向且保留 發布/放置,建議用 308。

如何用命令列檢查狀態碼?

可執行 `curl -I URL`,或 `curl -w "%{http_code}" -o /開發/null -s URL` 只顯示狀態碼。`wget --spider --伺服器-response` 或 HTTPie、Postman 也很方便。

能自訂狀態碼嗎?

IANA 登記的 100–599 才是標準。自行定義的狀態碼可能不被客戶端支援,建議仍使用標準碼,把錯誤細節放在回應內容即可。

相關文件

HTTP 狀態碼

返回工具頁面,立即使用相關功能。

開啟工具