为什么会出现 415 Unsupported Media Type（以及快速修复方法）

面向 415 报错的实战问题页：快速定位 Content-Type 错配并给出可复制修复方案。

415 大多不是业务代码错，而是媒体类型约定不一致。常见是 Content-Type 与请求体不匹配、参数异常，或代理层改写了头部。

本指南涉及工具

CTPContent-Type 解析器（MIME / Charset / Boundary）CTGContent-Type 生成器（MIME Header Builder）MIMEMIME Type 列表与 Content-Type 对照HDRHTTP Headers 解析器（Raw Header 转 JSON）REQHTTP 请求构建器

Symptoms（现象）

  • 请求一到服务端就返回 HTTP 415。
  • 同一接口在 Postman 可用，但前端/SDK 调用失败。
  • 文件上传看似发送成功，但服务端判定媒体类型不支持。

Root Cause（根因）

  • Content-Type 与请求体实际格式不一致（JSON/form-data/text）。
  • Header 参数不规范，如 charset 写法错误或 boundary 缺失。
  • 网关或代理改写请求头，导致关键参数丢失。

Fix Steps（修复步骤）

  1. 把原始 Content-Type 粘贴到 Content-Type Parser 做规范化校验。
  2. 若是 multipart 上传，确认 boundary 存在且与请求体分隔符一致。
  3. 用 Content-Type Generator 生成标准头后重放请求验证。

可直接复用的 JSON 请求头

Content-Type: application/json; charset=utf-8
Accept: application/json

Related Tool Workflow

先校验 Content-Type生成规范 Header重建请求并复测

FAQ

JSON 合法还会报 415 吗？

会。415 看的是媒体类型协定，不只看 JSON 语法。

JSON 一定要写 charset 吗？

跨环境时建议显式写 utf-8，兼容性更稳。