HTTP 415 Unsupported Media Type 是什麼意思？原因與解決方法

意義

請求本文的媒體類型（Content-Type）或編碼不受支援，伺服器拒絕了請求。

常見原因

傳送 JSON 時沒有 Content-Type: application/json
對只接受 JSON 的 API 傳送表單編碼本文
上傳時使用不支援的 Content-Encoding，例如 brotli

解決方法

用戶端或訪客

為傳送的本文設定正確的 Content-Type，並符合 API 文件規定的格式。

網站或 API 的維護者

在 Accept-Post 或 Accept-Patch 中列出接受的類型，並提供清楚的訊息。

回應範例

HTTP/1.1

HTTP/1.1 415 Unsupported Media Type
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Accept-Post: application/json
Content-Type: application/problem+json

{
  "type": "about:blank",
  "title": "Unsupported Media Type",
  "status": 415,
  "detail": "Send the body as application/json."
}

規範

RFC 9110 §15.5.16

常見問題

› 為什麼 fetch() 傳送 JSON 會得到 415？

若未設定 headers: {'Content-Type': 'application/json'}，fetch 對字串本文預設送出 text/plain。

› 415 與 400 的差別？

415 專指本文類型錯誤；400 泛指格式錯誤的請求。