100 Continue
伺服器已接收初始請求標頭,客戶端可繼續傳送請求主體資料。
除錯提示: 常見於搭配 Expect: 100-continue 標頭傳送大型酬載的情境。
快速搜尋 1xx–5xx HTTP 回應碼含義與 API/CDN 除錯建議。
伺服器已接收初始請求標頭,客戶端可繼續傳送請求主體資料。
除錯提示: 常見於搭配 Expect: 100-continue 標頭傳送大型酬載的情境。
伺服器同意升級連線通訊協定,最常見為從 HTTP 升級至 WebSocket。
除錯提示: 若 WebSocket 交握停滯,請檢查 Upgrade 與 Connection 標頭是否被代理移除。
標準成功回應,確認 HTTP 請求已順利處理並回傳內容。
除錯提示: 若前端仍發生解析錯誤,請核對回應標頭 Content-Type 與 JSON 結構。
請求已成功執行,並建立了一筆或多筆新的資源。
除錯提示: RESTful API 通常會在回應中附上指向新資源網址的 Location 標頭。
請求已成功處理,伺服器刻意回傳空白的回應主體。
除錯提示: 收到 204 回應(常見於 DELETE 或 CORS OPTIONS 預檢)請勿呼叫 response.json()。
伺服器僅傳送請求中 Range 標頭所要求的檔案位元組區段。
除錯提示: 常見於影片串流拖曳播放及支援斷點續傳的檔案下載。
資源已永久移至新網址,搜尋引擎會將 SEO 權重轉移過去。
除錯提示: 瀏覽器會積極快取 301 重新導向——測試新規則請改用無痕視窗或 curl -I。
資源暫時由另一個網址提供服務,原網址仍保留於搜尋索引。
除錯提示: 常見於 OAuth 登入轉址流程或系統維護期間的暫時分流。
依據 ETag 或 Last-Modified 比對結果,快取複本仍然有效。
除錯提示: 可節省靜態資源頻寬;若發現檔案版本過舊請檢查 Cache-Control 設定。
暫時性重新導向,且嚴格保留原本的 HTTP 方法與請求主體。
除錯提示: 當 POST 請求在轉址後必須維持為 POST 時,應使用 307 而非 302。
永久性重新導向,且嚴格保留原本的 HTTP 方法與請求主體。
除錯提示: 常見於 Next.js 結尾斜線規則導向以及全站強制 HTTPS 正規化。
因請求語法格式錯誤或參數無效,伺服器無法解析並處理請求。
除錯提示: 請檢查 JSON 語法、必填查詢參數以及 Content-Type 標頭是否正確。
目標端點缺少驗證資訊,或權杖已逾期、格式無效。
除錯提示: 請檢查 Authorization Bearer 權杖時效、API 金鑰前綴或工作階段 Cookie。
伺服器已辨識用戶端身分或命中安全規則,但該身分無權限存取。
除錯提示: 請檢查 RBAC 權限角色、CORS/WAF 規則或檔案與儲存貯體存取權。
伺服器找不到所請求的路由路徑或目標資源。
除錯提示: 請確認網址結尾斜線、basePath 路徑前綴、DNS 路由或是否誤用已刪除 ID。
請求的端點存在,但不支援此次使用的 HTTP 方法(如以 GET 呼叫 POST)。
除錯提示: 檢視回應標頭 Allow 即可確認該端點支援哪些 HTTP 方法。
用戶端傳送完整請求耗時過久,導致伺服器主動關閉連線。
除錯提示: 排查行動網路慢速上傳或用戶端與代理之間 keep-alive 逾時設定不一致。
此請求與目標資源目前的狀態或版本互相衝突。
除錯提示: 常見於重複註冊電子郵件,或樂觀鎖定更新時 ETag 不相符。
請求資料主體大小超出伺服器或反向代理允許的容量上限。
除錯提示: 上傳前可先在瀏覽器端壓縮圖片,或調高代理伺服器的主體大小限制。
伺服器拒絕接收 Content-Type 標頭所指定的資料格式。
除錯提示: 請確認實際資料與 Content-Type: application/json 或 multipart/form-data 一致。
語法格式合法(例如為合法 JSON),但欄位數值未通過語意驗證。
除錯提示: 查看錯誤明細以排查無效電子郵件格式、負數金額或缺少列舉欄位值。
用戶端已超過 API 的呼叫速率限制(Rate Limit)或突發配額。
除錯提示: 遵循 Retry-After 回應標頭,並搭配含隨機抖動(jitter)的指數退避重試。
原始伺服器處理請求期間發生未預期的未捕捉內部例外。
除錯提示: 檢視伺服器堆疊追蹤紀錄、遺漏的環境變數或資料庫連線異常。
反向代理、CDN 或負載平衡器從上游應用程式伺服器收到無效回應。
除錯提示: 確認上游服務程序是否正常運行且監聽在預期的連接埠上。
伺服器目前暫時過載,或正在進行排程維護而無法提供服務。
除錯提示: 檢查 Retry-After 標頭、健康檢查失敗紀錄或冷啟動資源耗盡情況。
代理伺服器或 CDN 在等待上游伺服器回應時逾時。
除錯提示: 優化執行過慢的資料庫查詢,或將耗時工作改由非同步背景佇列處理。
| 代碼 | 名稱 | 含義 | 除錯建議 | 複製 |
|---|---|---|---|---|
| 100 | 100 Continue | 伺服器已接收初始請求標頭,客戶端可繼續傳送請求主體資料。 | 常見於搭配 Expect: 100-continue 標頭傳送大型酬載的情境。 | |
| 101 | 101 Switching Protocols | 伺服器同意升級連線通訊協定,最常見為從 HTTP 升級至 WebSocket。 | 若 WebSocket 交握停滯,請檢查 Upgrade 與 Connection 標頭是否被代理移除。 | |
| 200 | 200 OK | 標準成功回應,確認 HTTP 請求已順利處理並回傳內容。 | 若前端仍發生解析錯誤,請核對回應標頭 Content-Type 與 JSON 結構。 | |
| 201 | 201 Created | 請求已成功執行,並建立了一筆或多筆新的資源。 | RESTful API 通常會在回應中附上指向新資源網址的 Location 標頭。 | |
| 204 | 204 No Content | 請求已成功處理,伺服器刻意回傳空白的回應主體。 | 收到 204 回應(常見於 DELETE 或 CORS OPTIONS 預檢)請勿呼叫 response.json()。 | |
| 206 | 206 Partial Content | 伺服器僅傳送請求中 Range 標頭所要求的檔案位元組區段。 | 常見於影片串流拖曳播放及支援斷點續傳的檔案下載。 | |
| 301 | 301 Moved Permanently | 資源已永久移至新網址,搜尋引擎會將 SEO 權重轉移過去。 | 瀏覽器會積極快取 301 重新導向——測試新規則請改用無痕視窗或 curl -I。 | |
| 302 | 302 Found | 資源暫時由另一個網址提供服務,原網址仍保留於搜尋索引。 | 常見於 OAuth 登入轉址流程或系統維護期間的暫時分流。 | |
| 304 | 304 Not Modified | 依據 ETag 或 Last-Modified 比對結果,快取複本仍然有效。 | 可節省靜態資源頻寬;若發現檔案版本過舊請檢查 Cache-Control 設定。 | |
| 307 | 307 Temporary Redirect | 暫時性重新導向,且嚴格保留原本的 HTTP 方法與請求主體。 | 當 POST 請求在轉址後必須維持為 POST 時,應使用 307 而非 302。 | |
| 308 | 308 Permanent Redirect | 永久性重新導向,且嚴格保留原本的 HTTP 方法與請求主體。 | 常見於 Next.js 結尾斜線規則導向以及全站強制 HTTPS 正規化。 | |
| 400 | 400 Bad Request | 因請求語法格式錯誤或參數無效,伺服器無法解析並處理請求。 | 請檢查 JSON 語法、必填查詢參數以及 Content-Type 標頭是否正確。 | |
| 401 | 401 Unauthorized | 目標端點缺少驗證資訊,或權杖已逾期、格式無效。 | 請檢查 Authorization Bearer 權杖時效、API 金鑰前綴或工作階段 Cookie。 | |
| 403 | 403 Forbidden | 伺服器已辨識用戶端身分或命中安全規則,但該身分無權限存取。 | 請檢查 RBAC 權限角色、CORS/WAF 規則或檔案與儲存貯體存取權。 | |
| 404 | 404 Not Found | 伺服器找不到所請求的路由路徑或目標資源。 | 請確認網址結尾斜線、basePath 路徑前綴、DNS 路由或是否誤用已刪除 ID。 | |
| 405 | 405 Method Not Allowed | 請求的端點存在,但不支援此次使用的 HTTP 方法(如以 GET 呼叫 POST)。 | 檢視回應標頭 Allow 即可確認該端點支援哪些 HTTP 方法。 | |
| 408 | 408 Request Timeout | 用戶端傳送完整請求耗時過久,導致伺服器主動關閉連線。 | 排查行動網路慢速上傳或用戶端與代理之間 keep-alive 逾時設定不一致。 | |
| 409 | 409 Conflict | 此請求與目標資源目前的狀態或版本互相衝突。 | 常見於重複註冊電子郵件,或樂觀鎖定更新時 ETag 不相符。 | |
| 413 | 413 Content Too Large | 請求資料主體大小超出伺服器或反向代理允許的容量上限。 | 上傳前可先在瀏覽器端壓縮圖片,或調高代理伺服器的主體大小限制。 | |
| 415 | 415 Unsupported Media Type | 伺服器拒絕接收 Content-Type 標頭所指定的資料格式。 | 請確認實際資料與 Content-Type: application/json 或 multipart/form-data 一致。 | |
| 422 | 422 Unprocessable Content | 語法格式合法(例如為合法 JSON),但欄位數值未通過語意驗證。 | 查看錯誤明細以排查無效電子郵件格式、負數金額或缺少列舉欄位值。 | |
| 429 | 429 Too Many Requests | 用戶端已超過 API 的呼叫速率限制(Rate Limit)或突發配額。 | 遵循 Retry-After 回應標頭,並搭配含隨機抖動(jitter)的指數退避重試。 | |
| 500 | 500 Internal Server Error | 原始伺服器處理請求期間發生未預期的未捕捉內部例外。 | 檢視伺服器堆疊追蹤紀錄、遺漏的環境變數或資料庫連線異常。 | |
| 502 | 502 Bad Gateway | 反向代理、CDN 或負載平衡器從上游應用程式伺服器收到無效回應。 | 確認上游服務程序是否正常運行且監聽在預期的連接埠上。 | |
| 503 | 503 Service Unavailable | 伺服器目前暫時過載,或正在進行排程維護而無法提供服務。 | 檢查 Retry-After 標頭、健康檢查失敗紀錄或冷啟動資源耗盡情況。 | |
| 504 | 504 Gateway Timeout | 代理伺服器或 CDN 在等待上游伺服器回應時逾時。 | 優化執行過慢的資料庫查詢,或將耗時工作改由非同步背景佇列處理。 |
快速搜尋 1xx–5xx HTTP 回應碼含義與 API/CDN 除錯建議。
401 代表尚未通過身分驗證(缺少或過期的 Token),403 則代表已識別身分但無權限存取該資源。
兩者皆為反向代理或 CDN 與後端原始伺服器之間的連線問題(502 為無效回應,504 為等待逾時)。