RestTemplate异常处理问题：客户端抛出异常无法在服务端捕获

我来帮你排查下这个问题~ 从你给出的代码片段来看，你在客户端的UserService里捕获了RestClientException然后直接抛出，但服务端没成功处理这个异常，大概率是这几个原因导致的：

客户端直接抛出的RestClientException属于Spring框架的内置异常，在跨服务调用场景下（比如HTTP远程调用、RPC调用），这类框架异常可能会被调用链路中的代理、序列化组件封装或吞掉，导致服务端无法直接捕获到它。

解决方案：
把框架异常转换成自定义业务异常，确保它能在跨服务调用中被正确序列化和传递。比如修改客户端的代码：

public class UserService {
    private static final Logger log = LoggerFactory.getLogger(UserService.class);
    
    public long createUser(Long serviceId){
        long userId = 0L;
        try {
            ResponseEntity<Object> response = restTemplate.exchange(url, HttpMethod.POST, request, Object.class);
            userId = response.getBody().getUser().getId();
        } catch(RestClientException e){
            log.error("调用下游服务创建用户失败，serviceId: {}", serviceId, e);
            // 抛出自定义业务异常，继承RuntimeException并实现Serializable
            throw new UserCreationFailedException("用户创建失败，请稍后重试", e);
        }
        return userId;
    }
}

如果客户端已经抛出了自定义异常，但服务端没有针对性地捕获或处理，也会出现“处理失败”的情况。

解决方案：

• 方式一：在服务端调用处直接捕获自定义异常

// 服务端调用客户端代码的地方
try {
    long userId = userService.createUser(serviceId);
    // 正常业务逻辑
} catch(UserCreationFailedException e){
    // 处理异常，比如返回错误响应给前端
    return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(e.getMessage());
}

• 方式二：用Spring全局异常处理器统一处理

@RestControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
    
    @ExceptionHandler(UserCreationFailedException.class)
    public ResponseEntity<String> handleUserCreationError(UserCreationFailedException e){
        log.error("用户创建流程异常", e);
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
    }
}

默认情况下，RestTemplate遇到HTTP错误状态码（如4xx、5xx）会自动抛出HttpClientErrorException/HttpServerErrorException（都是RestClientException子类），但如果你自定义了ResponseErrorHandler，可能改变了异常抛出的行为，导致异常没有被抛出而是返回了错误响应。

检查点：
查看你的RestTemplate配置，是否有类似这样的代码：

restTemplate.setErrorHandler(new DefaultResponseErrorHandler(){
    @Override
    protected boolean hasError(HttpStatus statusCode) {
        // 如果这里修改了错误状态码的判断逻辑，可能不会抛出异常
        return super.hasError(statusCode);
    }
});

如果是这个问题，要么恢复默认的ResponseErrorHandler，要么在自定义实现中主动抛出异常。

• 在客户端的catch块里添加详细日志，确认异常确实被捕获并抛出；
• 在服务端调用客户端方法的位置打印异常栈，看看实际接收到的异常类型是什么；
• 直接用Postman调用客户端的接口，模拟错误场景，确认客户端是否返回了预期的异常响应。

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