HTTP 狀態碼是伺服器對客戶端請求的標準化回應,分為五大類別。熟悉各代碼含義能加速除錯、優化 API 設計、改善使用者體驗。以下為完整分類速查表。
1xx 資訊回應(Informational)
| 代碼 | 名稱 | 說明 |
| 100 | Continue | 伺服器已收到請求標頭,客戶端應繼續發送請求主體 |
| 101 | Switching Protocols | 伺服器同意切換協議(如升級至 WebSocket) |
2xx 成功回應(Successful)
| 代碼 | 名稱 | 說明 |
| 200 | OK | 請求成功,回應內容視方法而定(GET 返回實體、POST 返回處理結果) |
| 201 | Created | 請求成功且已建立新資源,Location 標頭指向新資源 URI |
| 202 | Accepted | 請求已接受但尚未處理完成,常用於非同步任務 |
| 203 | Non-Authoritative Information | 回應來自代理伺服器快取,非原始伺服器 |
| 204 | No Content | 成功但無實體內容返回,瀏覽器保持當前頁面 |
| 205 | Reset Content | 成功並要求瀏覽器重置表單輸入 |
| 206 | Partial Content | 範圍請求成功,回應部份內容(支援斷點續傳) |
3xx 重導向(Redirection)
| 代碼 | 名稱 | 說明 |
| 300 | Multiple Choices | 多重選擇,提供連結清單供用戶選擇(最多 5 個) |
| 301 | Moved Permanently | 永久移動,搜尋引擎會轉移權重至新 URL |
| 302 | Found | 暫時移動,原 URL 保留權重 |
| 303 | See Other | 請用 GET 重新請求 Location 指定的 URI |
| 304 | Not Modified | 快取有效,配合 If-Modified-Since/ETag 使用 |
| 305 | Use Proxy | 必須透過 Location 指定的代理存取 |
| 307 | Temporary Redirect | 暫時重導向,要求保持原請求方法(POST 不變 GET) |
4xx 客戶端錯誤(Client Error)
| 代碼 | 名稱 | 說明 |
| 400 | Bad Request | 請求語法錯誤,伺服器無法理解 |
| 401 | Unauthorized | 需認證,回應含 WWW-Authenticate 標頭 |
| 403 | Forbidden | 伺服器拒絕授權,非認證問題 |
| 404 | Not Found | 資源不存在 |
| 405 | Method Not Allowed | 請求方法不被允許,回應含 Allow 標頭 |
| 408 | Request Timeout | 客戶端發送請求超時 |
| 413 | Payload Too Large | 請求實體過大 |
| 414 | URI Too Long | 請求 URI 過長 |
| 429 | Too Many Requests | 請求頻率超限(RFC 6585 新增) |
5xx 伺服器錯誤(Server Error)
| 代碼 | 名稱 | 說明 |
| 500 | Internal Server Error | 伺服器內部錯誤,未預期狀況 |
| 501 | Not Implemented | 伺服器不支援該請求功能 |
| 502 | Bad Gateway | 代理/閘道收到上游無效回應 |
| 503 | Service Unavailable | 服務暫時不可用(維護/過載),建議加 Retry-After |
| 504 | Gateway Timeout | 閘道等待上游回應超時 |
| 505 | HTTP Version Not Supported | 不支援請求中的 HTTP 版本 |
實務除錯小撇步
- 善用瀏覽器開發者工具 Network 面板查看實際狀態碼與回應標頭
- API 設計時:2xx 表成功、4xx 表客戶端錯誤(可修正)、5xx 表伺服器端錯誤(需運維介入)
- 301/302 選擇原則:SEO 永久遷移用 301,臨時活動/裝置適配用 302/307
- 404 頁面應提供搜尋、網站地圖、友善引導,降低跳出率
將此表加入書籤,下次遇到網路異常即可秒速定位問題核心。