WebGroundwebground.app
資訊與指南 · 網頁開發

HTTP 狀態碼與除錯參考

快速搜尋 1xx–5xx HTTP 回應碼含義與 API/CDN 除錯建議。

顯示 26 個狀態碼
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 在等待上游伺服器回應時逾時。

除錯提示: 優化執行過慢的資料庫查詢,或將耗時工作改由非同步背景佇列處理。

正在除錯 API 回傳內容嗎?可搭配使用JSON 格式化工具

HTTP 狀態碼與除錯參考

快速搜尋 1xx–5xx HTTP 回應碼含義與 API/CDN 除錯建議。

  • 伺服器已成功接收、理解並處理該 HTTP 請求。
  • 用戶端請求語法錯誤、未授權、找不到路徑或超過流量限制。
  • 後端伺服器發生例外錯誤、上游無回應或閘道器逾時。

常見問題 (FAQ)

HTTP 401 與 403 有什麼差別?+

401 代表尚未通過身分驗證(缺少或過期的 Token),403 則代表已識別身分但無權限存取該資源。

502 Bad Gateway 與 504 Gateway Timeout 代表什麼?+

兩者皆為反向代理或 CDN 與後端原始伺服器之間的連線問題(502 為無效回應,504 為等待逾時)。

探索更多 WebGround 工具

查看全部