使用Spring RestTemplate通过HashMap传参POST请求时出现400错误

嘿，我之前踩过一模一样的坑！你现在的代码直接把HashMap传给postForObject的请求体参数，这其实是RestTemplate的一个常见误区——它默认会把这个HashMap当成URL占位符变量去解析，而不是作为POST请求的请求体发送。服务器端根本收不到预期的参数，自然就返回400 Bad Request了。下面给你几个亲测有效的解决办法：

方法一：发送表单格式的请求（application/x-www-form-urlencoded） #

如果你的服务器端是接收表单参数的（比如用@RequestParam或者@ModelAttribute），那得把HashMap换成Spring专门处理表单的MultiValueMap：

import org.springframework.util.LinkedMultiValueMap;
import org.springframework.util.MultiValueMap;

// 替换HashMap为LinkedMultiValueMap
MultiValueMap<String, Object> formParams = new LinkedMultiValueMap<>();
formParams.add("param1", "param1val");

// 直接发送请求，RestTemplate会自动设置正确的请求头
YourResponseType response = restTemplate.postForObject(url, formParams, YourResponseType.class);

为什么要用MultiValueMap？因为它是Spring为表单数据设计的结构，能自动适配application/x-www-form-urlencoded格式，服务器端就能正确解析参数了。

方法二：发送JSON格式的请求（application/json） #

如果服务器端是接收JSON请求体的（比如用@RequestBody注解），那有两种方式处理：

方式1：直接传HashMap（自动序列化为JSON） #

只要你的项目里引入了Jackson依赖（Spring Boot默认已经包含），RestTemplate会自动把HashMap序列化成JSON，并设置Content-Type: application/json请求头：

Map<String, Object> jsonParams = new HashMap<>();
jsonParams.put("param1", "param1val");

YourResponseType response = restTemplate.postForObject(url, jsonParams, YourResponseType.class);

如果你的RestTemplate没配置JSON转换器，手动加一下就行：

RestTemplate restTemplate = new RestTemplate();
restTemplate.getMessageConverters().add(new MappingJackson2HttpMessageConverter());

方式2：手动转JSON字符串（更灵活） #

要是你需要自定义序列化规则，比如处理特殊字段，可以手动把HashMap转成JSON字符串，再封装成HttpEntity发送：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;

ObjectMapper objectMapper = new ObjectMapper();
String jsonBody = objectMapper.writeValueAsString(jsonParams);

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

HttpEntity<String> requestEntity = new HttpEntity<>(jsonBody, headers);
YourResponseType response = restTemplate.postForObject(url, requestEntity, YourResponseType.class);

最后：确认服务器端的接收方式 #

别忘检查服务器端的Controller代码，确保和你的请求格式匹配：

• 表单参数接收示例：

@PostMapping("/test")
public String receiveForm(@RequestParam("param1") String param1) {
    return "Got param: " + param1;
}

• JSON请求体接收示例：

@PostMapping("/test")
public String receiveJson(@RequestBody Map<String, Object> paramMap) {
    return "Got param: " + paramMap.get("param1");
}

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