Spring Boot RestTemplate POST请求返回500，Postman正常求助

我之前碰到过类似的问题，明明参数看起来完全一致，但RestTemplate就是返回服务器错误，而Postman能正常请求。结合你的代码来看，大概率是请求序列化方式或者RestTemplate配置细节出了问题，给你几个具体的排查和解决方向：

1. 先捕获500错误的详细响应内容 #

首先最关键的是搞清楚服务器返回500的具体原因，而不是只知道状态码。你可以在请求代码里添加异常捕获，打印服务器返回的错误体：

try {
    String _response = restTemplate.postForObject(url, request, String.class);
} catch (HttpServerErrorException e) {
    // 打印服务器返回的错误详情，这能直接帮你定位问题
    System.err.println("服务器返回的500错误详情: " + e.getResponseBodyAsString());
    e.printStackTrace();
}

比如服务器可能返回"参数格式错误"或者"无法解析JSON"，这会直接告诉你问题出在哪。

2. 避免手动序列化JSON（用Jackson代替org.json） #

你的代码里用了JSONObject.toString()来构造请求体，然后放到HttpEntity<String>里，这会和你配置的MappingJackson2HttpMessageConverter产生冲突——RestTemplate的消息转换器会尝试再次处理这个String，或者你的手动序列化结果和Postman发送的JSON存在细微差异（比如布尔值、空格、缩进）。

推荐直接用Jackson来处理序列化，要么定义POJO，要么用Map：

方式一：定义JSON-RPC请求的POJO #

// 定义请求结构的POJO
public class JsonRpcRequest {
    private String jsonrpc;
    private String method;
    private List<Object> params;
    private Integer id;

    // 生成getter和setter方法
    public String getJsonrpc() { return jsonrpc; }
    public void setJsonrpc(String jsonrpc) { this.jsonrpc = jsonrpc; }
    public String getMethod() { return method; }
    public void setMethod(String method) { this.method = method; }
    public List<Object> getParams() { return params; }
    public void setParams(List<Object> params) { this.params = params; }
    public Integer getId() { return id; }
    public void setId(Integer id) { this.id = id; }
}

然后修改abc()方法的请求构造：

public void abc() {
    String user = "...";
    String pass = "...";
    String url = "...";
    RestTemplate restTemplate = getRestTemplate(user, pass);

    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.APPLICATION_JSON);
    // 加上Accept头，和Postman保持一致
    headers.setAccept(Arrays.asList(MediaType.APPLICATION_JSON));

    // 构造请求体
    JsonRpcRequest requestBody = new JsonRpcRequest();
    requestBody.setJsonrpc("2.0");
    requestBody.setMethod("x");
    requestBody.setParams(Arrays.asList("a", "b", false));
    requestBody.setId(1);

    HttpEntity<JsonRpcRequest> request = new HttpEntity<>(requestBody, headers);
    
    try {
        String _response = restTemplate.postForObject(url, request, String.class);
        System.out.println("响应: " + _response);
    } catch (HttpServerErrorException e) {
        System.err.println("服务器错误详情: " + e.getResponseBodyAsString());
    }
}

方式二：用Map构造请求体（不用POJO） #

如果不想定义POJO，也可以用Map<String, Object>来构造：

Map<String, Object> requestBody = new HashMap<>();
requestBody.put("jsonrpc", "2.0");
requestBody.put("method", "x");
requestBody.put("params", Arrays.asList("a", "b", false));
requestBody.put("id", 1);

HttpEntity<Map<String, Object>> request = new HttpEntity<>(requestBody, headers);

3. 修正RestTemplate的配置问题 #

你的getRestTemplate方法里有两个潜在问题：

• 消息转换器设置了MediaType.ALL，这会导致Jackson转换器处理所有类型的请求/响应，容易和其他转换器冲突，应该只设置JSON类型；
• 请求工厂是在创建RestTemplate之后才设置的，这可能导致配置不生效，应该在构建时就指定。

修改后的getRestTemplate方法：

public RestTemplate getRestTemplate(String user, String pass) {
    RestTemplateBuilder restTemplateBuilder = new RestTemplateBuilder();
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
    // 只支持JSON媒体类型，避免冲突
    converter.setSupportedMediaTypes(Arrays.asList(
        MediaType.APPLICATION_JSON,
        MediaType.APPLICATION_JSON_UTF8
    ));
    converter.setObjectMapper(objectMapper());

    // 提前创建请求工厂，在构建RestTemplate时指定
    ClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(HttpClients.createDefault());

    return restTemplateBuilder
            .messageConverters(converter)
            .basicAuthorization(user, pass)
            .setConnectTimeout(120000)
            .setReadTimeout(120000)
            .requestFactory(() -> requestFactory) // 构建时设置请求工厂
            .build();
}

4. 对比Postman和RestTemplate的请求细节 #

如果上面的方法都没解决，你需要对比两者的请求是否完全一致：

• 请求头：Postman里的所有请求头（比如User-Agent、Accept、Content-Length等）都要和RestTemplate的一致，可以在Postman里导出请求的cURL，然后和RestTemplate发送的请求对比；
• 请求体：把RestTemplate发送的请求体打印出来（比如用objectMapper.writeValueAsString(requestBody)），和Postman里的Raw请求体逐字符对比，看是否有差异（比如引号、布尔值、空格等）。

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