SpringBoot restTemplate fastjson 中文乱码问题解决

最新推荐文章于 2025-05-11 14:53:44 发布

原创最新推荐文章于 2025-05-11 14:53:44 发布 · 4.3k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#restTemplate #fastjson

springboot 专栏收录该内容

5 篇文章

订阅专栏

本文介绍了在使用SpringBoot的restTemplate发送POST请求并接收JSON数据时出现中文乱码的问题。提供了两种解决方案：一是通过配置FastJsonHttpMessageConverter，设定MediaType为application/json;charset=UTF-8，并将其设为converters的第一个；二是若未使用fastjson，则可修改StringHttpMessageConverter的MediaType为application/json;charset=UTF-8。问题的根本原因在于restTemplate默认的消息转换器配置不支持UTF-8编码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

问题：

用restTemplate发送post请求，解析json数据，返回结果中文乱码。

String result = restTemplate.postForObject(restfulUrl, map, String.class);

解决：

方法一：使用FastJsonHttpMessageConverter，设置MediaType为application/json;charset=UTF-8，并放在converters中的第1位。

@Configuration
public class WebMvcConfig {

    @Bean
    public RestTemplate restTemplate() {
        RestTemplate restTemplate = new RestTemplate();
        List<HttpMessageConverter<?>> converters= restTemplate.getMessageConverters();
        List<MediaType> fastMediaTypes = new ArrayList<>();
        // 处理中文乱码问题
        fastMediaTypes.add(MediaType.APPLICATION_JSON_UTF8);
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
        fastConverter.setSupportedMediaTypes(fastMediaTypes);
        converters.add(0, fastConverter);
        return restTemplate;
    }
}

方法二：

如果没有使用fastjson，可以设置StringHttpMessageConverter的MediaType为application/json;charset=UTF-8

@Configuration
public class WebMvcConfig {

    @Bean
    public RestTemplate restTemplate() {
        RestTemplate restTemplate = new RestTemplate();
        StringHttpMessageConverter stringConverter = new StringHttpMessageConverter();
        List<HttpMessageConverter<?>> converters= restTemplate.getMessageConverters();
        List<MediaType> fastMediaTypes = new ArrayList<>();
        // 处理中文乱码问题
        fastMediaTypes.add(MediaType.APPLICATION_JSON_UTF8);
        stringConverter.setSupportedMediaTypes(fastMediaTypes);
        restTemplate.getMessageConverters().set(1, stringConverter);
        return restTemplate;
    }
}

原因：

因为restTemplate默认加载了好几个消息转换器(converters)，这里返回值类型是String，所以默认会使用StringHttpMessageConverter去处理，而StringHttpMessageConverter的媒体类型(MediaType)和字符集(charset)是text/plain 和ISO-8859-1，不符合要求，如下图。所以要设置下。