Spring微服务RestTemplate POST请求俄文转Base64问题及解决方法

原因解析 #

你遇到的俄文被自动转成Base64的问题，核心原因在于RestTemplate默认使用的FormHttpMessageConverter对非String类型的Object（或包含非ASCII字符的复杂对象）的处理逻辑：

• 当你将someObject直接放入MultiValueMap作为表单参数时，转换器会默认把它当作“二进制/复杂对象”处理，将其序列化为字节流后用Base64编码，以此来适配表单提交的格式要求。
• 英文文本之所以正常，是因为它属于ASCII字符集，转换器会直接将其当作普通字符串处理，跳过Base64编码步骤。

解决方法 #

下面提供几种从易到优的解决方案，你可以根据自身业务场景选择：

方案1：将对象序列化为JSON字符串后传输（快速适配现有代码）

这种方法不需要改动太多现有逻辑，只需要在客户端把someObject转成JSON字符串，服务端接收后再反序列化即可：

客户端修改代码：

// 引入Jackson的ObjectMapper（Spring Boot默认已集成）
ObjectMapper objectMapper = new ObjectMapper();
// 将someObject序列化为JSON字符串
String someObjectJson = objectMapper.writeValueAsString(someObject);

MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
// 放入JSON字符串而非原对象
body.add("somekey", someObjectJson);

HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(body, headers);
ResponseEntity<String> response = restTemplate.postForEntity(url, requestEntity, String.class);

服务端修改代码：

import com.fasterxml.jackson.databind.ObjectMapper;

public ResponseEntity<Item> someName(@RequestHeader Map<String, String> headers, @RequestParam("somekey") String data) {
    ObjectMapper objectMapper = new ObjectMapper();
    // 将JSON字符串反序列化为原对象
    SomeObject someObject = objectMapper.readValue(data, SomeObject.class);
    
    // 后续业务逻辑处理...
    return ResponseEntity.ok(item);
}

方案2：配置RestTemplate的表单消息转换器（保持表单提交方式）

如果你希望继续使用表单提交，可以自定义FormHttpMessageConverter的编码规则，强制使用UTF-8处理字符串，避免Base64编码：

客户端配置RestTemplate：

import org.springframework.http.converter.FormHttpMessageConverter;
import org.springframework.http.converter.StringHttpMessageConverter;
import java.nio.charset.StandardCharsets;

RestTemplate restTemplate = new RestTemplate();
// 遍历所有消息转换器，找到FormHttpMessageConverter并修改配置
for (HttpMessageConverter<?> converter : restTemplate.getMessageConverters()) {
    if (converter instanceof FormHttpMessageConverter) {
        FormHttpMessageConverter formConverter = (FormHttpMessageConverter) converter;
        // 设置表单默认编码为UTF-8
        formConverter.setCharset(StandardCharsets.UTF_8);
        
        // 调整内部的字符串转换器，确保非ASCII字符正常传输
        for (HttpMessageConverter<?> partConverter : formConverter.getPartConverters()) {
            if (partConverter instanceof StringHttpMessageConverter) {
                ((StringHttpMessageConverter) partConverter).setDefaultCharset(StandardCharsets.UTF_8);
                ((StringHttpMessageConverter) partConverter).setWriteAcceptCharset(false);
            }
        }
    }
}

修改后，someObject中的俄文字符会以UTF-8编码直接传输，服务端接收的String就是正常的俄文文本。

方案3：改用JSON请求体（推荐的REST实践）

表单提交更适合简单键值对，复杂对象的传输更推荐使用JSON请求体，这也是Spring微服务的常规做法，从根源上避免表单编码问题：

客户端修改代码：

// 直接将someObject作为请求体，不需要MultiValueMap
HttpEntity<SomeObject> requestEntity = new HttpEntity<>(someObject, headers);
// 注意：RestTemplate默认已支持JSON转换器（Spring Boot环境）
ResponseEntity<String> response = restTemplate.postForEntity(url, requestEntity, String.class);

服务端修改代码：

// 使用@RequestBody直接接收对象，无需手动处理字符串
public ResponseEntity<Item> someName(@RequestHeader Map<String, String> headers, @RequestBody SomeObject someObject) {
    // 直接使用someObject，俄文文本保持正常
    // 后续业务逻辑处理...
    return ResponseEntity.ok(item);
}

内容的提问来源于stack exchange，提问作者Maayan Hope