Spring REST异常：如何从ResourceAccessException获取响应负载？

这个问题很常见！在Spring的RestTemplate场景下，400这类客户端HTTP错误确实可能被包装进ResourceAccessException里，但完全可以从中提取响应负载里的errorMessage并传递到调用链上层。核心思路是拆解异常链找到原始HTTP错误异常，再解析响应体拿到目标字段，以下是handleErrors方法的具体实现方案：

1. 遍历异常链，定位可获取响应体的异常 #

400错误对应的原始异常是HttpClientErrorException（属于4xx客户端错误的专用异常类型），它继承自HttpStatusCodeException，自带获取响应体的方法。我们需要从RestClientException的异常链里逐层找到它：

private RuntimeException handleErrors(RestClientException ex, String url) {
    // 逐层遍历异常链，定位目标HTTP错误异常
    Throwable currentEx = ex;
    while (currentEx != null) {
        if (currentEx instanceof HttpClientErrorException httpClientEx) {
            // 提取响应体并解析出errorMessage
            String errorMsg = parseErrorMessage(httpClientEx.getResponseBodyAsString());
            // 抛出自定义异常，将errorMessage传递到上层调用链
            throw new CustomServiceException("调用接口[" + url + "]失败: " + errorMsg, ex);
        }
        currentEx = currentEx.getCause();
    }
    // 若未找到目标异常，抛出通用错误
    throw new CustomServiceException("调用接口[" + url + "]发生未知错误", ex);
}

2. 解析响应体，提取errorMessage #

假设接口返回的错误响应是JSON格式（比如{"errorMessage": "参数格式不符合要求"}），我们可以用Jackson的ObjectMapper来解析：

private String parseErrorMessage(String responseBody) {
    ObjectMapper objectMapper = new ObjectMapper();
    try {
        JsonNode rootNode = objectMapper.readTree(responseBody);
        // 用path方法避免字段不存在时抛出异常，返回默认兜底信息
        return rootNode.path("errorMessage").asText("未知错误");
    } catch (JsonProcessingException e) {
        // 解析失败时返回原始响应体，便于排查问题
        return "错误响应解析失败: " + responseBody;
    }
}

3. 自定义业务异常（推荐） #

建议自定义一个继承RuntimeException的业务异常，这样上层调用链可以针对性捕获它，直接获取携带的errorMessage：

public class CustomServiceException extends RuntimeException {
    public CustomServiceException(String message, Throwable cause) {
        super(message, cause);
    }
}

额外注意事项 #

• 确保RestTemplate的错误处理器没有丢弃响应体：默认的DefaultResponseErrorHandler会保留响应体，如果是自定义错误处理器，要保证在抛出异常时传递响应体信息。
• 兼容边界情况：比如响应体为空、errorMessage字段不存在、响应格式非JSON等，都要在解析方法里做兼容处理，避免新异常中断错误流程。

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