Feign 是一个声明式的 Web 服务客户端,它使得编写 Web 服务客户端变得更加简单。在使用 Feign 时,我们通常会处理两种类型的错误:Feign 异常(FeignException)和远程服务错误(如 HTTP 状态码表示的错误)。
- 处理 Feign 异常(FeignException):
FeignException 是一个通用的异常,它包含了 Feign 调用的详细信息,如错误代码、错误消息等。要处理 FeignException,你可以在你的接口方法中使用 @ExceptionHandler
注解来捕获并处理这个异常。例如:
@ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(FeignException.class) public ResponseEntityhandleFeignException(FeignException e) { // 处理 FeignException,例如返回自定义的错误响应 return ResponseEntity.status(e.status()).body("Feign Exception: " + e.getMessage()); } }
- 处理远程服务错误:
当远程服务返回非 200 的 HTTP 状态码时,Feign 会抛出一个 FeignException.Error
异常。要处理这种错误,你可以在你的接口方法中使用 @ExceptionHandler
注解来捕获并处理这个异常。例如:
@ControllerAdvice public class GlobalExceptionHandler { @ExceptionHandler(FeignException.Error.class) public ResponseEntityhandleFeignError(FeignException.Error e) { // 处理 FeignError,例如返回自定义的错误响应 return ResponseEntity.status(e.status()).body("Remote Service Error: " + e.getMessage()); } }
此外,你还可以使用 ErrorDecoder
接口来自定义错误处理逻辑。要创建一个自定义的 ErrorDecoder
,你需要实现这个接口并实现 decode
方法。例如:
public class CustomErrorDecoder implements ErrorDecoder { @Override public Exception decode(Response response) { // 根据响应状态码和响应体创建自定义异常 if (response.status() == HttpStatus.NOT_FOUND) { return new ResourceNotFoundException("Resource not found"); } else if (response.status() == HttpStatus.INTERNAL_SERVER_ERROR) { return new ServerErrorException("Internal server error"); } else { return new FeignException.Error(response.status(), response.body().string()); } } }
然后,你需要在你的 Feign 客户端配置中注册这个自定义的 ErrorDecoder
。例如:
@Configuration public class FeignClientConfig { @Bean public ErrorDecoder errorDecoder() { return new CustomErrorDecoder(); } @Bean public Feign.Builder feignBuilder(ErrorDecoder errorDecoder) { return Feign.builder() .client(new Retryer.Default(100, 1000, 3)) .decoder(errorDecoder); } }
这样,当远程服务返回错误状态码时,Feign 会使用你提供的自定义 ErrorDecoder
来处理错误。