HTTP 狀態碼
完整的 HTTP 狀態碼參考指南,包含所有標準狀態碼的詳細說明、使用場景和範例。幫助開發者快速查詢和理解 HTTP 響應碼含義。
100
Continue
繼續
伺服器已收到請求頭,客戶端應繼續發送請求主體。常用於客戶端需要發送大量資料時。
101
Switching Protocols
切換協定
伺服器已理解並願意遵守客戶端的請求,通過 Upgrade 頭欄位切換到不同的協定。常用於 WebSocket 連線建立。
102
Processing
處理中
伺服器已收到並正在處理請求,但還沒有響應可用。用於防止客戶端逾時。
103
Early Hints
早期提示
主要用於與 Link 頭一起使用,允許使用者代理在伺服器準備響應時開始預載入資源。
200
OK
成功
請求已成功,請求所希望的響應頭或資料體將隨此響應返回。這是最常見的 HTTP 狀態碼。
201
Created
已建立
請求已經被實現,新的資源已經依據請求的需要而建立。通常在 POST 請求或某些 PUT 請求之後返回。
202
Accepted
已接受
伺服器已接受請求,但尚未處理。請求最終可能會也可能不會被執行。用於非同步處理。
203
Non-Authoritative Information
非權威資訊
伺服器是一個轉換代理,已成功處理請求,但返回的實體頭部可能是來自原始伺服器的副本。
204
No Content
無內容
伺服器成功處理了請求,但不需要返回任何實體內容。常用於 DELETE 或 PUT 請求的響應。
205
Reset Content
重置內容
伺服器成功處理了請求,但沒有返回任何內容。與 204 不同的是,此響應要求請求者重置文件檢視。
206
Partial Content
部分內容
伺服器已經成功處理了部分 GET 請求。常用於斷點續傳或分段下載。
300
Multiple Choices
多種選擇
被請求的資源有一系列可供選擇的回饋資訊,使用者或瀏覽器能夠自行選擇一個首選的位址進行重新導向。
301
Moved Permanently
永久移動
被請求的資源已永久移動到新位置。搜尋引擎會更新其索引。應該使用新的 URI 存取資源。
302
Found
臨時移動
請求的資源臨時從不同的 URI 響應請求。由於這樣的重新導向是臨時的,客戶端應繼續使用原有 URI。
303
See Other
檢視其他位置
對應當前請求的響應可以在另一個 URI 上被找到,客戶端應使用 GET 方法獲取請求的資源。
304
Not Modified
未修改
資源未被修改。客戶端可以使用快取的版本。常用於條件 GET 請求,可以減少資料傳輸。
307
Temporary Redirect
臨時重新導向
請求的資源臨時從不同的 URI 響應請求。與 302 不同的是,客戶端應繼續使用原有的請求方法。
308
Permanent Redirect
永久重新導向
資源已永久移動到新位置。與 301 不同的是,客戶端應繼續使用原有的請求方法。
400
Bad Request
錯誤請求
伺服器無法理解請求的格式。客戶端不應該在未修改的情況下重複此請求。常見於語法錯誤或參數錯誤。
401
Unauthorized
未授權
請求要求使用者的身份認證。客戶端必須提供有效的身份驗證憑據才能存取資源。
402
Payment Required
需要付款
該狀態碼被保留以便將來使用。最初的意圖是用於數位支付系統。
403
Forbidden
禁止存取
伺服器理解請求,但拒絕執行。與 401 不同,身份驗證不會改變響應結果。常見於權限不足。
404
Not Found
未找到
請求的資源在伺服器上不存在。這是最常見的錯誤狀態碼之一。URL 可能拼寫錯誤或資源已被刪除。
405
Method Not Allowed
方法不被允許
請求使用的 HTTP 方法不被允許。例如,對唯讀資源使用 POST 方法。
406
Not Acceptable
不可接受
請求的資源的內容特性無法滿足請求頭中的條件,因此無法生成響應實體。
407
Proxy Authentication Required
需要代理授權
客戶端必須先通過代理伺服器進行身份驗證。
408
Request Timeout
請求逾時
伺服器等待客戶端發送的請求時間過長,逾時。客戶端可以隨時再次提交這一請求。
409
Conflict
衝突
由於和被請求的資源的當前狀態之間存在衝突,請求無法完成。常見於並行更新衝突。
410
Gone
已刪除
請求的資源在伺服器上已經不可用,且沒有已知的轉發位址。與 404 不同,410 表明這是永久性的。
411
Length Required
需要內容長度
伺服器拒絕在沒有定義 Content-Length 頭的情況下接受請求。
412
Precondition Failed
前提條件失敗
伺服器在驗證請求的頭欄位中給出的前提條件時,發現至少有一個前提條件不滿足。
413
Payload Too Large
請求實體過大
伺服器拒絕處理當前請求,因為請求的實體資料大小超過伺服器願意或能夠處理的範圍。
414
URI Too Long
請求 URI 過長
請求的 URI 長度超過了伺服器能夠解釋的長度。
415
Unsupported Media Type
不支援的媒體類型
請求中提交的實體並不是伺服器支援的格式。
416
Range Not Satisfiable
請求範圍不符合要求
客戶端請求的範圍無效。常見於斷點續傳時請求的範圍超出檔案大小。
417
Expectation Failed
期望失敗
伺服器無法滿足 Expect 請求頭中指定的期望條件。
418
I'm a teapot
我是茶壺
這是一個愚人節玩笑,源自 1998 年的 RFC 2324。伺服器拒絕煮咖啡因為它是個茶壺。
421
Misdirected Request
請求錯誤定向
請求被定向到無法產生響應的伺服器。
422
Unprocessable Entity
無法處理的實體
請求格式正確,但由於語義錯誤而無法處理。常用於表單驗證失敗。
423
Locked
已鎖定
當前資源被鎖定。常用於 WebDAV。
424
Failed Dependency
依賴失敗
由於之前的某個請求發生的錯誤,導致當前請求失敗。
425
Too Early
太早
伺服器拒絕處理在 Early Data 中的請求,以規避可能的重放攻擊。
426
Upgrade Required
需要升級
伺服器拒絕使用當前協定執行請求,但可能在客戶端升級到不同的協定後願意執行。
428
Precondition Required
需要前提條件
伺服器要求請求是有條件的。用於防止'遺失更新'問題。
429
Too Many Requests
請求過多
使用者在給定的時間內發送了太多的請求。常用於限流或防止濫用。
431
Request Header Fields Too Large
請求頭欄位太大
伺服器拒絕處理請求,因為請求頭欄位太大。
451
Unavailable For Legal Reasons
因法律原因不可用
該資源因法律原因不可用。常用於因版權、審查等原因無法存取的內容。
500
Internal Server Error
伺服器內部錯誤
伺服器遇到意外的情況,阻止其執行請求。這是伺服器端最常見的錯誤狀態。
501
Not Implemented
未實作
伺服器不支援請求的功能,無法完成請求。例如,伺服器無法識別請求方法。
502
Bad Gateway
錯誤的閘道
作為閘道或代理工作的伺服器從上游伺服器收到無效響應。
503
Service Unavailable
服務不可用
伺服器暫時無法處理請求。通常是由於伺服器過載或維護。這通常是暫時狀態。
504
Gateway Timeout
閘道逾時
作為閘道或代理工作的伺服器,未能及時從上游伺服器收到請求。
505
HTTP Version Not Supported
HTTP 版本不支援
伺服器不支援請求中所用的 HTTP 協定版本。
506
Variant Also Negotiates
變體協商錯誤
伺服器存在內部配置錯誤,請求的透明內容協商導致迴圈引用。
507
Insufficient Storage
儲存空間不足
伺服器無法儲存完成請求所必須的內容。常用於 WebDAV。
508
Loop Detected
檢測到迴圈
伺服器在處理請求時檢測到無限迴圈。
510
Not Extended
未擴充套件
客戶端需要對請求進一步擴充套件,伺服器才能實現它。
511
Network Authentication Required
需要網路認證
客戶端需要進行身份驗證才能獲得網路存取權限。常用於需要登入的公共 WiFi。
什麼是 HTTP 狀態碼?
HTTP 狀態碼是伺服器對客戶端請求的標準響應代碼。每個狀態碼都是一個三位數字,第一位數字定義了響應的類別。理解這些狀態碼對於 Web 開發、API 偵錯和問題排查非常重要。
狀態碼分類
- 1xx (資訊回應) - 表示請求已被接收,繼續處理。這類響應是臨時響應,只包含狀態行和某些可選的響應頭資訊。
- 2xx (成功回應) - 表示請求已成功被伺服器接收、理解並接受。這是最常見的成功響應類型。
- 3xx (重新導向) - 表示需要客戶端採取進一步的操作才能完成請求。通常用於重新導向,這類狀態碼用來告訴客戶端使用新的 URL 重新發送請求。
- 4xx (用戶端錯誤) - 表示客戶端看起來可能發生了錯誤,妨礙了伺服器的處理。例如請求語法錯誤、請求無法完成、請求頁面不存在等。
- 5xx (伺服器錯誤) - 表示伺服器無法完成明顯有效的請求。這類狀態碼代表了伺服器在處理請求的過程中有錯誤或者異常狀態發生。