HTTP 狀態碼由三位數字構成,第一位決定它屬於哪一類。看懂這五個分類,大多數除錯情境都能快速定位問題出在哪一端。
1xx:繼續
屬於臨時性回應,告知用戶端「你的請求我收到了,請繼續」。
- 100 Continue:伺服器已收到請求的開頭部分,正在等待其餘內容。
- 101 Switching Protocols:用戶端要求切換協定,伺服器已確認並準備切換(WebSocket 握手即用此碼)。
2xx:成功
請求已被成功接收並處理。
- 200 OK:最常見的成功回應,通常表示伺服器已回傳請求的網頁。
- 201 Created:請求成功,且伺服器建立了新資源(多見於 PUT/POST 建立資源後)。
- 202 Accepted:伺服器已接受請求,但尚未處理完成。
- 203 Non-Authoritative Information:處理成功,但回傳的資訊可能來自第三方來源而非原始伺服器。
- 204 No Content:處理成功,但沒有回傳任何內容。
- 205 Reset Content:處理成功,要求用戶端重置檢視內容。
- 206 Partial Content:成功處理了部分的 GET 請求,是斷點續傳與多區段下載的基礎。
3xx:重新導向
要完成請求,用戶端需要採取進一步動作,通常用於轉址。
- 300 Multiple Choices:有多種可行操作,伺服器可代為選擇或提供清單供用戶端挑選。
- 301 Moved Permanently:資源已永久搬移。收到此回應時,用戶端會自動轉往新位置,且此後應直接存取新網址。SEO 上的網址搬遷即依賴此碼。
- 302 Found(臨時搬移):伺服器目前從別的位置回應,但用戶端後續請求仍應使用原始網址。
- 303 See Other:請用戶端改用另一個 GET 請求去取得回應內容,常用於 POST 之後導向結果頁。
- 304 Not Modified:自上次請求後資源未被修改,因此不回傳內容。這是瀏覽器快取機制的核心。
- 305 Use Proxy:只能透過代理存取該資源。
- 307 Temporary Redirect:與 302 類似,但明確要求不得變更請求方法。
4xx:用戶端錯誤
請求本身有問題,妨礙了伺服器處理。
- 400 Bad Request:伺服器無法理解請求語法。
- 401 Unauthorized:需要身分驗證,通常用於需登入的頁面。
- 403 Forbidden:伺服器理解請求但拒絕執行。
- 404 Not Found:找不到請求的資源。
- 405 Method Not Allowed:請求中使用的方法被停用。
- 406 Not Acceptable:無法產生符合請求內容特徵的回應。
- 407 Proxy Authentication Required:類似 401,但要求的是代理伺服器的授權。
- 408 Request Timeout:伺服器等待請求時逾時。
- 409 Conflict:請求與目前資源狀態衝突,回應中應包含衝突的相關資訊。
- 410 Gone:資源已永久刭除,且不打算再恢復。
- 411 Length Required:請求缺少有效的 Content-Length 標頭。
- 412 Precondition Failed:請求中設定的某個前置條件未被滿足。
- 413 Payload Too Large:請求內容超出伺服器處理能力。
- 414 URI Too Long:請求的 URI 過長,伺服器無法處理。
- 415 Unsupported Media Type:請求的格式不受支援。
- 416 Range Not Satisfiable:無法提供請求的範圍。
- 417 Expectation Failed:未滿足 Expect 請求標頭欄位的要求。
5xx:伺服器端錯誤
伺服器在處理請求的過程中發生內部錯誤——問題不在用戶端。
- 500 Internal Server Error:通用錯誤碼,伺服器遇到未預期的狀況而無法完成請求。後端程式拋出未捕捉的例外時最常見。
- 501 Not Implemented:伺服器不具備完成請求的功能,例如無法識別請求方法。
- 502 Bad Gateway:作為閘道或代理的伺服器,從上游收到了無效回應。反向代理後面的服務掛掉時常見。
- 503 Service Unavailable:伺服器暫時無法使用(過載或維護中),通常屬於暫時狀態,實務上常搭配 Retry-After 標頭。
- 504 Gateway Timeout:作為閘道或代理,未能及時從上游收到回應。
- 505 HTTP Version Not Supported:伺服器不支援請求中使用的 HTTP 協定版本。
實務上的判讀口訣
4xx 先懷疑自己的請求寫錯了(網址、參數、權限、標頭);5xx 則該去查伺服器日誌與上游服務狀態。3xx 通常是正常的轉址流程,但 301 與 302 用錯會直接影響 SEO。2xx 也不必然代表一切正常——204 沒有 body、206 只回傳部分內容,都是需要特別留意的情況。