SpringBoot RestTemplate解析含URL的MediaType报无效令牌字符错误

问题根源 #

Spring的MediaType解析器严格遵循RFC规范（RFC 7231、RFC 2616），MIME类型的参数值若包含非token字符（比如冒号:、斜杠/等），必须用双引号包裹，否则会被判定为无效token。PostMan对MIME类型的解析规则更宽松，允许未加引号的特殊字符，因此能正常使用，但RestTemplate依赖的Spring内部解析器执行严格校验，导致报错。

修复步骤 #

将profile参数的值用双引号包裹，修改后的MediaType定义如下：

MediaType customMediaType = MediaType.parseMediaType("application/json; profile=\"http://realtime-listings.webservices.zpg.co.uk/docs/v2.0/schemas/listing/list.json\"");

验证说明 #

修改后，Spring的MediaType解析器会正确识别包含特殊字符的参数值，不会再抛出「Invalid token character ':'」的错误。使用RestTemplate发送请求时，该自定义MediaType会被正确格式化并放入请求头中。

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