HTTP 狀態碼速查

全部 IANA 狀態碼的含義與處理建議——按數字、名稱或症狀搜尋。

顯示 64 / 64 個狀態碼

狀態碼

1xx資訊5

100Continue繼續

伺服器已收到請求頭,客戶端可以繼續傳送請求體。

怎麼辦繼續傳送請求體;如果請求已經發送完畢,可以忽略這個響應。

101Switching Protocols切換協議

伺服器接受了 Upgrade 請求,正在切換到另一種協議。

怎麼辦之後按 Upgrade 響應頭裡指定的協議通訊。

102Processing處理中

WebDAV已廢棄

WebDAV 伺服器已接受請求,但還沒有處理完成。

怎麼辦保持連線,等待最終響應。

103Early Hints早期提示

伺服器在最終響應前先發 Link 頭,讓客戶端可以提前預載入或預連線。

怎麼辦現在開始預載入或預連線,同時繼續等待最終狀態碼。

104Upload Resumption Supported支援斷點續傳

草案

表示中斷的上傳可以繼續;這仍是 Internet-Draft,尚未成為正式 RFC。

怎麼辦按伺服器給出的偏移量續傳,並預期協議行為仍可能變化。

2xx成功10

200OK成功

請求成功;具體含義取決於所用的 HTTP 方法。

怎麼辦按方法讀取響應體或響應頭。

201Created已建立

請求成功,並且新建了一個資源。

怎麼辦用響應裡的 Location 頭找到新資源。

202Accepted已接受

請求已被接受處理,但還沒有完成。

怎麼辦輪詢狀態介面;不要假設任務已經完成。

203Non-Authoritative Information非權威資訊

返回的後設資料來自副本,而不是直接來自源伺服器。

怎麼辦把它當作代理或本地變體;需要準確資訊時回源核對。

204No Content無內容

請求成功,但沒有響應體需要返回。

怎麼辦根據狀態碼和響應頭更新介面,不要等待響應體。

205Reset Content重置內容

客戶端應重置發起該請求的檔案或表單。

怎麼辦清空觸發請求的表單或檢視。

206Partial Content部分內容

伺服器返回了資源中請求的那一段位元組範圍。

怎麼辦把位元組追加到緩衝區;需要時繼續請求下一段。

207Multi-Status多狀態

WebDAV

WebDAV 響應裡包含多個資源各自的狀態。

怎麼辦解析 XML 響應體,分別處理每個資源的狀態。

208Already Reported已報告

WebDAV

同一個繫結裡的成員已經列過,因此不再重複。

怎麼辦跳過重複成員,處理之前那次響應即可。

226IM Used已使用例項操作

響應是對當前表示應用增量操作後的結果(HTTP 增量編碼)。

怎麼辦把例項操作應用到本地快取副本上。

3xx重定向9

300Multiple Choices多種選擇

同一個資源有多個可選表示,客戶端需要選擇一個。

怎麼辦從響應裡選一個表示,或使用協商好的預設表示。

301Moved Permanently永久移動

資源已永久移動,之後的請求應使用新 URL。

怎麼辦把書籤、連結和站點地圖更新為 Location 指向的 URL。

302Found臨時移動

資源暫時可以從另一個 URL 訪問。

怎麼辦本次請求跟隨 Location,但之後仍使用原 URL。

303See Other檢視其他位置

客戶端應該用 GET 去另一個資源讀取這次請求的結果。

怎麼辦用 GET 跟隨 Location 讀取結果。

304Not Modified未修改

快取

快取副本仍然有效,因此不需要返回響應體。

怎麼辦直接使用快取響應;這個響應本身沒有響應體。

305Use Proxy使用代理

已廢棄

客戶端被告知要通過代理訪問資源;該狀態碼已廢棄。

怎麼辦不要使用它,直接配置代理即可。

306Unused未使用

保留

早期規範保留的碼值,現在已沒有定義。

怎麼辦忽略它;不存在標準行為。

307Temporary Redirect臨時重定向

資源暫時在別處,並且請求方法不能改變。

怎麼辦用相同的方法和請求體向 Location 重新發起請求。

308Permanent Redirect永久重定向

資源已永久移動,並且請求方法不能改變。

怎麼辦更新連結,並用相同方法向 Location 重新發起請求。

4xx客戶端錯誤29

400Bad Request錯誤請求

伺服器無法處理請求,因為客戶端發來的內容不合法。

怎麼辦檢查 URL、請求頭和請求體語法;修正後再重試。

401Unauthorized未授權

認證

需要身份認證,或者提供的憑證被拒絕了。

怎麼辦傳送有效憑證;檢查 WWW-Authenticate 響應頭。

402Payment Required需要付款

預留給需要付費的服務使用,實際很少出現。

怎麼辦檢查該 API 的計費/支付流程;沒有標準響應體。

403Forbidden禁止訪問

認證

伺服器理解了請求,但拒絕授權。

怎麼辦換用有許可權的賬號或令牌;不要盲目重試。

404Not Found未找到

伺服器找不到請求的資源:可能是 URL 寫錯、路由未註冊,或資源已被刪除。

怎麼辦核對 URL 與路由,並確認資源是否已被刪除,再決定是否重試。

405Method Not Allowed方法不允許

這個資源不支援請求所用的 HTTP 方法。

怎麼辦改用 Allow 響應頭裡列出的方法。

406Not Acceptable不可接受

沒有任何表示能匹配請求裡的 Accept 條件。

怎麼辦放寬 Accept 頭,或改用伺服器支援的格式。

407Proxy Authentication Required需要代理認證

認證

客戶端與伺服器之間的代理要求先認證。

怎麼辦配置代理憑證;檢查 Proxy-Authenticate 響應頭。

408Request Timeout請求超時

伺服器沒有在時限內收到完整請求。

怎麼辦換更快的網路重試,或把超時時間調長。

409Conflict衝突

請求與資源當前狀態發生衝突。

怎麼辦先獲取最新狀態並解決衝突,再重試。

410Gone已刪除

資源已被永久刪除,而且沒有轉發地址。

怎麼辦移除連結和快取,不要重試。

411Length Required需要長度

伺服器要求 Content-Length 響應頭,但請求沒有提供。

怎麼辦補上 Content-Length,或改用分塊傳輸編碼。

412Precondition Failed前置條件失敗

If-Match、If-Unmodified-Since 等條件頭沒有滿足。

怎麼辦獲取當前版本,用新的校驗值重試。

413Content Too Large內容過大

請求體超過了伺服器允許的大小。

怎麼辦減少資料、壓縮後再發,或改用分塊上傳。

414URI Too LongURI 過長

請求的 URL 超過了伺服器能接受的長度。

怎麼辦縮短查詢串,或把資料放進請求體。

415Unsupported Media Type不支援的媒體型別

伺服器不支援請求體的媒體型別。

怎麼辦改用受支援的 Content-Type;查閱 API 檔案。

416Range Not Satisfiable範圍無法滿足

請求的位元組範圍無法在這個資源上滿足。

怎麼辦檢查資源大小,重新請求合法的 Range。

417Expectation Failed期望失敗

伺服器無法滿足 Expect 請求頭裡的期望。

怎麼辦去掉或修改 Expect 頭後重試。

418I'm a Teapot我是茶壺

保留

來自 RFC 2324 的愚人節狀態碼;RFC 9110 已把 418 註冊為未使用。

怎麼辦不要依賴它;不存在標準行為。

421Misdirected Request請求方向錯誤

伺服器無法為這個 scheme 與 authority 組合生成響應。

怎麼辦換一條能服務該源的連線重試。

422Unprocessable Content無法處理的實體

WebDAV

請求語法合法,但語義上無法處理。

怎麼辦修正校驗錯誤;檢視響應體裡的詳細錯誤。

423Locked已鎖定

WebDAV

WebDAV 資源被另一個請求鎖定了。

怎麼辦釋放鎖,或帶上鎖令牌再請求。

424Failed Dependency依賴失敗

WebDAV

這次請求依賴的先前請求失敗了。

怎麼辦先修復先前的操作,再重試這一批請求。

425Too Early過早

請求可能被重放,伺服器拒絕處理;常見於 TLS 早期資料。

怎麼辦稍後重試,或不要使用早期資料重新發送。

426Upgrade Required需要升級

伺服器要求換用另一種協議才能處理請求。

怎麼辦按 Upgrade 頭指定的協議重試。

428Precondition Required需要前置條件

伺服器要求請求帶條件,以避免丟失更新。

怎麼辦在請求裡帶上 If-Match 或 If-Unmodified-Since。

429Too Many Requests請求過多

這個客戶端的請求頻率超過了限流閾值。

怎麼辦退避等待,並按 Retry-After 的時長再試。

431Request Header Fields Too Large請求頭欄位過大

請求頭欄位的大小超過了伺服器限制。

怎麼辦減少 Cookie 或請求頭大小後重試。

451Unavailable For Legal Reasons因法律原因不可用

伺服器因法律原因拒絕提供該資源。

怎麼辦聯絡站點運營方;這是有意攔截。

5xx服務端錯誤11

500Internal Server Error伺服器內部錯誤

伺服器遇到意外情況,無法完成請求。

怎麼辦檢視伺服器日誌;只有瞬時錯誤才值得重試。

501Not Implemented未實現

伺服器不支援請求所要求的 HTTP 方法。

怎麼辦改用受支援的方法;伺服器至少要支援 GET 和 HEAD。

502Bad Gateway閘道器錯誤

閘道器或代理從上游伺服器收到了無效響應。

怎麼辦檢查上游服務,並用退避策略重試。

503Service Unavailable服務不可用

伺服器過載或正在維護。

怎麼辦按 Retry-After 給出的時長重試。

504Gateway Timeout閘道器超時

閘道器沒有及時收到上游伺服器的響應。

怎麼辦檢查上游延遲,並調長超時後重試。

505HTTP Version Not SupportedHTTP 版本不受支援

伺服器不支援請求使用的 HTTP 版本。

怎麼辦改用 HTTP/1.1 或其他受支援的版本重試。

506Variant Also Negotiates變體協商錯誤

內容協商配置錯誤,協商結果又指回了自身。

怎麼辦修正伺服器的協商配置;這是服務端缺陷。

507Insufficient Storage儲存空間不足

WebDAV

WebDAV 伺服器無法儲存完成請求所需的表示。

怎麼辦釋放儲存空間,或減小請求體積。

508Loop Detected檢測到迴圈

WebDAV

WebDAV 伺服器在處理請求時發現了無限迴圈。

怎麼辦修正導致迴圈的配置或資料。

510Not Extended未擴充套件

已廢棄

客戶端必須宣告伺服器需要的 HTTP 擴充套件;該狀態碼已淘汰。

怎麼辦升級客戶端,或改用受支援的 API。

511Network Authentication Required需要網路認證

認證

客戶端需要先認證才能訪問網路,例如公共 Wi-Fi 的登入門戶。

怎麼辦開啟網路登入頁並完成認證。

怎麼用

  1. 在搜尋框裡輸入:數字(404)、英文官方短語(Not Found),或症狀詞(超時、限流)。列表隨輸入即時更新,沒有提交按鈕。
  2. 用 1xx–5xx 的 chip 收窄範圍;它與搜尋詞疊加,例如「4xx 認證」只留下帶認證標記的 4xx。
  3. 每張卡片給出碼值、官方 reason phrase、含義和下一步建議。reason phrase 保持英文,因為 HTTP 報文裡傳的就是這串字元。
  4. 點卡片上的「複製」可複製規範的「404 Not Found」一行,寫工單或提交資訊時直接貼上;「重設」同時清空搜尋詞與類別篩選。

示例

搜尋

404

結果

404 Not Found —— 4xx · 客戶端錯誤
伺服器找不到請求的資源:可能是 URL 寫錯、路由未註冊,或資源已被刪除。
怎麼辦:核對 URL 與路由,並確認資源是否已被刪除,再決定是否重試。

「404」是全形輸入,頁面先折成半形再匹配;搜尋同樣命中別名與症狀詞,例如「限流」能找到 429。「404 快取」則按快取說明同時找到 404 與 304。

範圍與限制

  • 列表以 IANA HTTP Status Code Registry 為準:截至 2026-10-25 共 64 條。nginx 499、Cloudflare 52x 等廠商自定義碼不在範圍內。
  • 邊緣項如實標註:104 仍是 Internet-Draft;102 / 305 / 510 已廢棄;306 / 418 為保留,418 同時給出 RFC 2324 愚人節出處。
  • reason phrase 是官方 ASCII 原文,不做翻譯;伺服器可能返回不同的短語,但客戶端真正依據的是三位數字。
  • 這是速查表,不是 URL 檢測器:頁面不會向任何站點發請求,因此無法判斷某個網址為什麼返回該狀態碼——那需要看對應伺服器與日誌。
  • 搜尋完全在本頁完成:不上傳、不儲存、不寫進 URL;分享按鈕只分享本頁地址。

排查狀態碼前後的請求與響應時,這些工具通常用得上。