RestTemplate中文乱码完美解决方案

RestTemplate中对字符串使用的是StringHttpMessageConverter中默认的编码

public class StringHttpMessageConverter extends AbstractHttpMessageConverter<String> { //省略其他代码 public static final Charset DEFAULT_CHARSET = StandardCharsets.ISO_8859_1; }

ISO_8859_1编码格下，中文是乱码的。因此我们需要将编码格式设置为UTF-8的格式才能支持中文。
网络上大部分的教程都是通过以下方式来修改编码格式

RestTemplate restTemplate = new RestTemplate(); restTemplate.getMessageConverters().set(1, new StringHttpMessageConverter(StandardCharsets.UTF_8));

原因是在RestTemplate的构造函数中，对messageConverters赋值时，在下标为1的位置设置的是StringHttpMessageConverter对象。

public class RestTemplate extends InterceptingHttpAccessor implements RestOperations { public RestTemplate() { this.messageConverters.add(new ByteArrayHttpMessageConverter()); this.messageConverters.add(new StringHttpMessageConverter());//此处设置 this.messageConverters.add(new ResourceHttpMessageConverter(false)); //省略其他代码 } }

但是这种写死下标的方式是极为不推荐的，因为不排除Spring在后续版本中因为引入了其他转换器而导致下标变化的问题。推荐使用以下方式。

public static void setRestTemplateEncode(RestTemplate restTemplate) { if (null == restTemplate || ObjectUtils.isEmpty(restTemplate.getMessageConverters())) { return; } List<HttpMessageConverter<?>> messageConverters = restTemplate.getMessageConverters(); for (int i = 0; i < messageConverters.size(); i++) { HttpMessageConverter<?> httpMessageConverter = messageConverters.get(i); if (httpMessageConverter.getClass().equals(StringHttpMessageConverter.class)) { messageConverters.set(i, new StringHttpMessageConverter(StandardCharsets.UTF_8)); } } }

我们新增一个方法，将RestTemplate对象传递进去，内部遍历messageConverters，找到StringHttpMessageConverter并替换为UTF-8格式的StringHttpMessageConverter对象即可。

以上方式自己亲测可用，如果使用了上述方式还是乱码的话，可以排查下是不是后端没有设置编码格式