为什么Spring Boot返回List<String>为JSON,返回String却为HTML?
响应格式差异原因
@RestController本质是@Controller + @ResponseBody组合注解,仅保证接口不会走视图解析器渲染页面,会直接把方法返回值写入响应体,但具体的序列化格式、响应的Content-Type由Spring MVC的内容协商机制和HttpMessageConverter(HTTP消息转换器)的匹配规则决定:
/helloworld接口返回List<String>类型:Spring默认没有能直接处理集合类型的纯文本消息转换器,因此会自动匹配到Jackson的JSON消息转换器MappingJackson2HttpMessageConverter,将集合序列化为JSON数组,响应头Content-Type为application/json,所以你看到的是JSON格式响应。/hello接口返回String类型:会优先匹配到专门处理字符串的StringHttpMessageConverter,这个转换器默认支持所有文本类型的响应。如果你是用浏览器直接访问接口,浏览器默认发送的请求Accept头中text/html的优先级高于text/plain,因此转换器会自动把响应Content-Type设为text/html,浏览器就会把返回内容识别为HTML格式处理,这就是你看到HTML响应的原因,实际返回的内容本身还是纯文本Hello。
让/hello接口返回JSON的解决方案
如果你需要/hello也返回JSON格式,可以任选以下一种方案实现:
- 修改接口返回值为非String的引用类型,比如用Map或者自定义响应实体包装返回内容:
这种方案会自动走JSON转换器,返回@GetMapping(path = "/hello") public Map<String, String> sayHello(){ return Map.of("msg", "Hello"); }{"msg":"Hello"}格式的JSON响应。 - 显式指定接口的响应媒体类型,强制用JSON序列化:
这种方案返回的JSON内容为带引号的字符串@GetMapping(path = "/hello", produces = "application/json") public String sayHello(){ return "Hello"; }"Hello",符合JSON格式规范。 - 全局调整消息转换器顺序,把Jackson JSON转换器放到
StringHttpMessageConverter之前,所有接口会优先走JSON序列化,该方案会影响全局所有返回String的接口,需要根据业务场景评估使用。
内容的提问来源于stack exchange,提问作者wick3d
相关产品推荐
相关产品推荐

