意義
請求成功,沒有需要回傳的本文。標頭仍可攜帶新的 ETag 等中繼資料。
常見原因
- DELETE 成功
- PUT 或 PATCH 儲存了變更但不回傳資源
- CORS 預檢或 beacon 端點的回應
解決方法
用戶端或訪客
不要嘗試解析本文;對 204 呼叫 response.json() 會拋出例外。讀取前先檢查狀態碼。
網站或 API 的維護者
204 絕不能附本文。如果用戶端需要更新後的資源,就回傳帶 JSON 的 200。
回應範例
HTTP/1.1
HTTP/1.1 204 No Content
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx 規範
常見問題
› 為什麼對 204 呼叫 response.json() 會失敗?
因為沒有可解析的本文。呼叫 json() 前先檢查 response.status === 204(或內容長度)。
› DELETE 應該回傳 204 還是 200?
沒有內容要回報時回傳 204;回傳被刪除的項目或確認訊息等本文時回傳 200。