REST接口返回Base64编码JSON字符串时MediaType应如何设置？

• 你当前使用的@Produces(MediaType.APPLICATION_JSON)配置是错误的。该媒体类型声明响应内容为原生JSON结构，但你实际返回的是JSON经Base64编码后的字符串，调用方直接按JSON格式解析会直接报错。
• 完全不需要切换为URL编码对应的媒体类型：application/x-www-form-urlencoded是专门用于表单键值对提交的请求媒体类型，和你的响应场景完全不匹配，使用会导致调用方对响应结构产生错误预期。

可选的正确MediaType方案，你可以根据业务场景二选一： #

1. 优先选用带参数扩展的JSON媒体类型
   配置为@Produces("application/json;encoding=base64")，符合RFC规范中媒体类型的参数扩展规则，明确告知调用方：响应内容的本质是JSON，仅额外做了一层Base64编码，调用方解码后按JSON格式解析即可，语义最清晰。
2. 通用无业务语义的媒体类型
   如果你不希望在媒体类型中透露内容本质是JSON，可选用@Produces(MediaType.APPLICATION_OCTET_STREAM)（通用二进制内容类型）或者@Produces(MediaType.TEXT_PLAIN)（纯文本类型），前者适配性更高。

额外建议：无论选择哪种媒体类型，都建议在接口文档中明确说明响应内容需要先做Base64解码再解析JSON的流程，降低对接成本。

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