如何将Spring Cloud OpenFeign自定义ErrorDecoder异常传递给客户端？

问题根源 #

• 未配置Fallback时，Feign默认会把ErrorDecoder抛出的异常包装成NoFallbackAvailableException，导致全局异常处理器无法直接捕获原始业务异常
• 配置普通Fallback时，Feign会捕获所有异常并执行降级逻辑，异常不会向上传递到全局处理器

解决方案 #

前提准备：定义自定义业务异常 #

先创建一个能携带状态码和错误信息的自定义异常，方便全局处理器识别和返回：

public class RemoteServiceException extends RuntimeException {
    private int statusCode;
    private String errorMessage;

    public RemoteServiceException(int statusCode, String errorMessage) {
        super(errorMessage);
        this.statusCode = statusCode;
        this.errorMessage = errorMessage;
    }

    // Getter方法
    public int getStatusCode() { return statusCode; }
    public String getErrorMessage() { return errorMessage; }
}

方案1：不使用Fallback（仅需异常透传） #

步骤1：调整ErrorDecoder抛出自定义异常

修改你的DepartmentClientErrorDecoder，解析响应后直接抛出RemoteServiceException，而非默认的FeignException：

public class DepartmentClientErrorDecoder implements ErrorDecoder {
    private final ErrorDecoder defaultDecoder = new Default();

    @Override
    public Exception decode(String methodKey, Response response) {
        try {
            // 解析响应体获取错误信息
            String errorMsg = Util.toString(response.body().asReader(Util.UTF_8));
            return new RemoteServiceException(response.status(), errorMsg);
        } catch (IOException e) {
            // 解析失败时使用默认解码器
            return defaultDecoder.decode(methodKey, response);
        }
    }
}

步骤2：全局异常处理器处理包装异常

在@RestControllerAdvice中添加对NoFallbackAvailableException的处理，提取内部的自定义异常并返回：

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 处理自定义业务异常
    @ExceptionHandler(RemoteServiceException.class)
    public ResponseEntity<ErrorResponse> handleRemoteServiceException(RemoteServiceException e) {
        ErrorResponse error = new ErrorResponse(e.getStatusCode(), e.getErrorMessage());
        return new ResponseEntity<>(error, HttpStatus.valueOf(e.getStatusCode()));
    }

    // 处理无Fallback时的包装异常
    @ExceptionHandler(NoFallbackAvailableException.class)
    public ResponseEntity<ErrorResponse> handleNoFallbackException(NoFallbackAvailableException e) {
        if (e.getCause() instanceof RemoteServiceException) {
            RemoteServiceException cause = (RemoteServiceException) e.getCause();
            return handleRemoteServiceException(cause);
        }
        // 其他未知异常返回默认错误
        ErrorResponse error = new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), "服务调用失败，无降级处理");
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }

    // 错误响应DTO
    static class ErrorResponse {
        private int code;
        private String message;

        public ErrorResponse(int code, String message) {
            this.code = code;
            this.message = message;
        }

        // Getter方法
    }
}

方案2：使用FallbackFactory（需降级+异常透传） #

如果需要降级逻辑，但又要在特定场景下透传异常，用FallbackFactory替代普通Fallback，它能获取到触发降级的原始异常：

步骤1：实现FallbackFactory

@Component
public class DepartmentClientFallbackFactory implements FallbackFactory<DepartmentClient> {

    @Override
    public DepartmentClient create(Throwable cause) {
        return new DepartmentClient() {
            @Override
            public Department getDepartmentById(Long id) {
                // 若是自定义业务异常，直接抛出交给全局处理器
                if (cause instanceof RemoteServiceException) {
                    throw (RemoteServiceException) cause;
                }
                // 其他异常返回降级结果，或也可抛出统一降级异常
                throw new RemoteServiceException(HttpStatus.SERVICE_UNAVAILABLE.value(), "服务临时降级，稍后重试");
            }
        };
    }
}

步骤2：FeignClient指定FallbackFactory

@FeignClient(
    name = "department-service",
    configuration = DepartmentClientConfig.class,
    fallbackFactory = DepartmentClientFallbackFactory.class
)
public interface DepartmentClient {
    @GetMapping("/departments/{id}")
    Department getDepartmentById(@PathVariable("id") Long id);
}

步骤3：全局异常处理器复用方案1中的逻辑

无需额外修改，全局处理器会捕获RemoteServiceException并返回对应响应。

关键配置注意 #

• 如果使用Hystrix，需确保feign.hystrix.enabled=true（Spring Cloud Finchley及以后版本默认关闭，需在application.yml中手动开启）
• 若无需降级，直接不配置fallback或fallbackFactory即可

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