You need to enable JavaScript to run this app. 为什么Spring Boot返回List<String>为JSON,返回String却为HTML?
优惠活动
大模型
产品
解决方案
定价
更多

为什么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或者自定义响应实体包装返回内容:
    @GetMapping(path = "/hello")
    public Map<String, String> sayHello(){
        return Map.of("msg", "Hello");
    }
    
    这种方案会自动走JSON转换器,返回{"msg":"Hello"}格式的JSON响应。
  • 显式指定接口的响应媒体类型,强制用JSON序列化:
    @GetMapping(path = "/hello", produces = "application/json")
    public String sayHello(){
        return "Hello";
    }
    
    这种方案返回的JSON内容为带引号的字符串"Hello",符合JSON格式规范。
  • 全局调整消息转换器顺序,把Jackson JSON转换器放到StringHttpMessageConverter之前,所有接口会优先走JSON序列化,该方案会影响全局所有返回String的接口,需要根据业务场景评估使用。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.10 18:03:02