Quarkus中REST资源方法数量不同时，非预期Content-Type抛出异常不一致问题

问题背景 #

在Quarkus 3.4.3环境中，使用quarkus-resteasy-reactive-jsonb扩展实现带媒体类型版本控制的JAX-RS资源时，发现异常抛出存在不一致性：

• 资源仅含单个方法时，发送非预期Content-Type请求会抛出jakarta.ws.rs.NotSupportedException
• 资源包含多个方法时，同样请求会抛出jakarta.ws.rs.WebApplicationException

该问题导致异常映射器逻辑混乱，增加了调试成本，且切换到reactive扩展前（使用quarkus-resteasy-jsonb）未出现此问题。

1. 是否是操作失误导致的问题？ #

不是。从测试代码来看，资源方法已通过@Consumes正确标注支持的媒体类型，测试请求也正确构造了不符合要求的Content-Type头，代码逻辑符合JAX-RS规范，不存在用户操作层面的错误。

2. 这是Quarkus的Bug还是特性？ #

这属于Quarkus/Resteasy Reactive的Bug。
根据JAX-RS规范，当请求的Content-Type不被目标资源的任何方法支持时，应统一抛出NotSupportedException（对应HTTP 415 Unsupported Media Type状态码）。多方法场景下抛出WebApplicationException属于实现逻辑不一致：

• 单方法场景下，框架直接校验请求媒体类型与方法标注的匹配性，抛出规范定义的异常
• 多方法场景下，框架的方法匹配逻辑在处理媒体类型不匹配时，错误地使用了通用的WebApplicationException而非规范要求的特定异常

另外，传统quarkus-resteasy-jsonb扩展无此问题，也验证了这是Reactive版本特有的实现缺陷。

3. 是否有其他人遇到过类似问题？ #

是的，已有其他开发者在Quarkus的GitHub Issues中反馈过类似的Reactive JAX-RS方法匹配、媒体类型校验环节的异常不一致问题。部分相关问题已在Quarkus后续稳定版本（如3.8+）中修复，建议升级到最新稳定版本测试是否解决该问题。

临时解决方案 #

1. 异常映射器兼容处理：在自定义异常映射器中同时捕获NotSupportedException和WebApplicationException，判断后者是否对应415状态码，统一返回标准化的415响应
2. 临时降级扩展：若业务允许，暂时切换回quarkus-resteasy-jsonb扩展，规避Reactive版本的此缺陷

内容的提问来源于stack exchange，提问作者Fin Steenbjerg