如何通过RestTemplate发送UTF-8格式的MULTIPART_FORM_DATA？配置无效求帮助

嘿，我懂你碰到的麻烦了——明明给RestTemplate加了StringHttpMessageConverter指定UTF-8，可发送multipart/form-data请求时编码还是不对对吧？这其实是个常见的误区，我来帮你理清原因并给出解决方案：

为什么你的原有配置不生效？ #

StringHttpMessageConverter主要负责处理纯文本类的请求/响应（比如text/plain、application/json这类Content-Type），但multipart/form-data类型的请求是由专门的FormHttpMessageConverter来处理的。你单独把String转换器放在最前面，根本影响不到multipart请求的编码逻辑。

正确的配置方式 #

你需要找到RestTemplate中的FormHttpMessageConverter，并修改它的字符编码设置，同时还要确保它内部的子转换器也使用UTF-8：

RestTemplate restTemplate = new RestTemplate();

// 遍历所有消息转换器，定位到FormHttpMessageConverter
for (HttpMessageConverter<?> converter : restTemplate.getMessageConverters()) {
    if (converter instanceof FormHttpMessageConverter) {
        FormHttpMessageConverter formConverter = (FormHttpMessageConverter) converter;
        // 设置表单整体的UTF-8编码
        formConverter.setCharset(Charset.forName("UTF-8"));
        
        // 还要配置表单内部的文本部分转换器为UTF-8
        List<HttpMessageConverter<?>> partConverters = formConverter.getPartConverters();
        for (HttpMessageConverter<?> partConverter : partConverters) {
            if (partConverter instanceof StringHttpMessageConverter) {
                ((StringHttpMessageConverter) partConverter).setDefaultCharset(Charset.forName("UTF-8"));
            }
        }
        break;
    }
}

额外注意事项 #

• 如果你的multipart请求包含文件，文件部分本身是二进制流，不需要编码设置，重点要保证文本字段（比如表单参数、描述信息）的编码正确。
• 如果你用的是Spring Boot，也可以通过配置类来统一配置RestTemplate，避免每次创建都重复写这段代码。

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