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 泛指格式错误的请求。