一、背景
当两个服务通过HTTP通信的时候,客户端会接收到的是一个由服务端返回的Response。那些客户端的“神器”,例如:Retrofit、FeignClient,通过对Response进行处理,让客户端有了好像调用本地方法的感觉。至此,听起来都是那么美好是不?遗憾的是,在使用FeignClient的时候,客户端是无法拿到服务端抛出的自定义异常的,取而代之是FeignException,是不是变得不那么顺滑了呢?这样的结果导致客户端无法根据不同的异常进行有针对性的处理。
为了要解决这个问题,下面的时间里我将介绍下我的解决方案。
二、解决方案
1、自定义异常类(BizException)
服务端在处理具体业务的时候,会出现一些错误导致业务无法正常进行下去,例如:支付的时候余额不足,下单的时候库存不足等等,针对此种情况统一采用抛出一个自定义的业务异常(BizException),同时采用错误码来区分各种错误,具体代码如下:
@Data
public class BizException extends RuntimeException {
/**
* 错误码
*/
private String code;
/**
* 错误信息
*/
private String msg;
/**
* 数据
*/
private Object data;
}
2、服务端统一处理 BizException
通过 @ExceptionHandler 统一处理被抛出的 BizException,代码如下:
通过上边的代码,我们可以看到,当遇到 BizException 的时候,Response 中的 status,会被重写为600。
3、客户端统一处理 status==600 的 Response
客户端通过实现 feign.codec.ErrorDecoder 接口拦截 Response,将 status==600 的 Response 转化为BizException,代码如下:
4、整体思路
服务端抛出 BizException 同时将该BizException转换为 status == 600 的 Response,客户端接收到 status == 600 的 Response 同时将此 Response 转换为 BizException,如下图:
三、案例
下面将以 annoroad-alpha、annoroad-beta、annoroad-ms-spring-boot-starter 为例来进一步的说明下。
首先介绍下它们都是啥都:
- annoroad-alpha:作为本例的客户端,引用 annoroad-ms-spring-boot-starter
- annoroad-beta:作为本例的服务端,引用 annoroad-ms-spring-boot-starter
- annoroad-ms-spring-boot-starter:
1、将抛出的 BizException 转换为 status == 600 的 Response
2、将接收到的 Response(status == 600) 转换成 BizException
1、annoroad-alpha、annoroad-beta 的调用关系
2、BizException 处理的全过程
3、抛出的 BizException 转换为 status == 600 的 Response 的过程
被黑框框起来的部分对应「解决方案中的 2 」,如下图:
4、将接收到的 Response(status == 600) 转换成 BizException 的过程
被黑框框起来的部分对应「解决方案中的 3 」,如下图: