Spring Boot跨服务调用RestTemplate时遇NULL错误及HttpClientError问题

你遇到的这个问题其实是RestTemplate的默认行为导致的——当服务端返回4xx（比如你这里的FORBIDDEN 403）或5xx状态码时，RestTemplate会直接抛出HttpClientErrorException（或对应类型的异常），而不是把错误响应体封装到ResponseEntity里返回。所以你代码里的uploadResponse根本没机会被正常赋值，自然拿不到错误消息，反而会触发异常。

下面给你两种常用的解决方案：

方案一：捕获异常并提取响应体 #

直接在调用代码处捕获HttpClientErrorException，然后从异常对象中提取服务端返回的响应体内容：

try {
    ResponseEntity<Object> uploadResponse = restTemplate.exchange(
        "http://TESTAPPLICATION/v1/object", 
        HttpMethod.POST, 
        requestEntity, 
        Object.class
    );
    // 处理正常响应逻辑
} catch (HttpClientErrorException e) {
    // 获取原始响应体字符串
    String errorBodyStr = e.getResponseBodyAsString();
    // 如果你需要，可以把字符串解析成自定义的ResponseEntity类
    ObjectMapper objectMapper = new ObjectMapper();
    com.test.models.ResponseEntity errorResponse = objectMapper.readValue(errorBodyStr, com.test.models.ResponseEntity.class);
    System.out.println("服务端返回的错误消息：" + errorResponse.getMessage());
}

注意：如果使用Jackson的ObjectMapper，要确保它能正确解析服务端返回的JSON结构，比如你的自定义ResponseEntity类字段要和JSON键对应。

方案二：自定义错误处理器，让RestTemplate返回所有状态的ResponseEntity #

如果你希望不管服务端返回什么状态码，RestTemplate都能正常返回ResponseEntity而不是抛出异常，可以自定义一个ResponseErrorHandler：

public class NonThrowingErrorHandler extends DefaultResponseErrorHandler {
    @Override
    public boolean hasError(HttpStatus statusCode) {
        // 返回false，表示所有状态码都不被视为错误
        return false;
    }

    @Override
    public void handleError(ClientHttpResponse response) throws IOException {
        // 空实现，不触发异常逻辑
    }
}

然后在配置RestTemplate时绑定这个错误处理器：

@Bean
public RestTemplate restTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.setErrorHandler(new NonThrowingErrorHandler());
    return restTemplate;
}

配置完成后，调用exchange方法时，即使服务端返回403，也会返回包含错误状态码和响应体的ResponseEntity，你可以直接从响应中提取错误消息：

ResponseEntity<Object> uploadResponse = restTemplate.exchange(
    "http://TESTAPPLICATION/v1/object", 
    HttpMethod.POST, 
    requestEntity, 
    Object.class
);
if (uploadResponse.getStatusCode().equals(HttpStatus.FORBIDDEN)) {
    com.test.models.ResponseEntity errorResponse = (com.test.models.ResponseEntity) uploadResponse.getBody();
    System.out.println("服务端返回的错误消息：" + errorResponse.getMessage());
}

额外建议 #

如果你的项目是Spring Boot 2.x及以上版本，其实可以考虑用WebClient替代RestTemplate（RestTemplate已处于维护模式）。WebClient的错误处理更灵活，默认不会抛出异常，而是返回包含错误信息的Mono/Flux，更适合微服务间的异步调用场景。

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