You need to enable JavaScript to run this app. Jetty服务器REST POST接口返回HTTP 415 Unsupported Media Type错误
优惠活动
大模型
产品
解决方案
定价
更多

Jetty服务器REST POST接口返回HTTP 415 Unsupported Media Type错误

Jetty环境下JAX-RS接口返回415 Unsupported Media Type的常见原因

415错误的核心触发逻辑非常明确:服务端在请求路由匹配完成后,会根据请求头的Content-Type值,去查找对应注册的MessageBodyReader实现来读取请求体。如果找不到能匹配该媒体类型的读取器,就会直接抛出415错误。这个错误根本不会走到JSON反序列化、参数绑定的流程,和你请求体里的JSON结构是否和Model类匹配没有直接关系。

常见遗漏的配置/操作

  • 未引入JAX-RS对应的JSON序列化/反序列化扩展模块
    JAX-RS核心包本身不内置JSON转Java对象的处理能力,多数人搭建Jetty上的JAX-RS(基于Jersey、RestEasy实现)时,只引入了REST核心依赖,没有引入对应JSON处理的扩展模块,导致运行时根本没有能处理application/json类型请求体的阅读器,自然会抛出415。
  • 请求头的Content-Type格式不规范
    你设置的请求头值为application/json;,末尾多了一个无意义的分号。部分严格遵循HTTP规范的JAX-RS实现,在媒体类型匹配时会因为这个多余的分号导致解析结果和接口声明的MediaType.APPLICATION_JSON不完全匹配,直接判定为不支持的媒体类型。
  • 跨框架注解混用导致请求体识别逻辑异常
    你代码中方法参数上的@RequestBody是Spring MVC的专属注解,并非标准JAX-RS的注解。如果你的运行环境是纯JAX-RS(未整合Spring MVC),这个注解根本不会被解析;如果环境处于半整合状态,但没有正确配置Spring的消息转换器,就会导致服务端无法正确识别请求体的处理逻辑,触发媒体类型不匹配的报错。
  • 服务端包扫描配置遗漏了JSON提供者
    哪怕已经引入了JSON处理依赖,如果Jetty中部署的JAX-RS应用没有把对应依赖包里的MessageBodyReader实现类纳入扫描、注册范围,运行时依然找不到对应的JSON处理能力。比如Jersey应用没有配置扫描路径覆盖Jackson的提供者包,就会出现依赖存在但功能不生效的问题。

快速排查步骤

  1. 先把客户端请求头里Content-Type末尾多余的分号去掉,替换为标准写法Content-Type: application/json重新发起请求,排除媒体类型解析不匹配的问题。
  2. 检查项目依赖,确认是否引入了对应JAX-RS实现的JSON媒体模块:
    • 使用Jersey的场景需要引入jersey-media-json-jackson依赖
    • 使用RestEasy的场景需要引入resteasy-jackson2-provider依赖
  3. 移除纯JAX-RS环境下方法参数上多余的Spring专属@RequestBody注解——标准JAX-RS会自动把符合@Consumes声明类型的请求体绑定到匹配的Java类型参数上,不需要额外注解。
  4. 核对服务端的包扫描配置,确保JSON相关的提供者类不会被排除在注册范围外。

内容的提问来源于stack exchange,提问作者dhalfageme

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 11:36:02