https://github.com/yinjihuan/kitty-cloud
异常处理不用我讲,大家都清楚。单独的异常处理太繁琐,全局异常处理可以在一个应用中统一进行异常的处理,非常方便。目前全局异常处理用的也越来越广泛,今天跟大家来聊一聊 Kitty Cloud 中的全局异常是如何处理的?
为什么要使用全局异常处理呢?使用全局异常处理后,我们不需要定义固定类型的返回值,当业务代码报错的时候直接通过异常处理方式来返回给前端或者 API 调用方错误信息。
不使用全局异常处理案例 Web 层比如我们定义了一个 ResponseData 用来返回固定格式的数据,正常情况下不会有问题,给前端返回的格式也是固定的,如下:
{ "code":200, "data":{ "name":"yinjihuan" }, "message":"success", }如果业务发生异常,那么这个接口就不会返回上面那样固定格式的数据了,会给我们返回错误页面。除了代码异常还有一种情况就是当访问的 Uri 错误的时候,也会给调用方返回 404 的错误页面,如下:
如果是传统的 Web 项目,里面包含了页面这是没问题的,我们也可以自定义错误页面让用户体验更好一点。但是在这个基本上是前后端分离的开发模式下,后端只提供的数据的 API,不会有页面的内容。所以就算出错了,就算使用者调用的 API 路径错了,也应该返回固定的格式,并且告诉调用方路径错了。所以我们需要全局的异常处理。
业务层在业务层最常见的用法就是我们可以直接抛出自定义异常,这样在全局异常处理后给调用方返回的还是固定的格式,如果没有全局异常处理,我们可能会用固定的 Response 来做这件事,比如下面的代码:
public Response createOrder(CreateOrderParam param) { Response checkResponse = paramsCheck(param); if (!checkResponse.isSuccess()) { return checkResponse(); } ........... } private Response paramsCheck(CreateOrderParam param) { if (param.getTotalPrice() <= 0){ return Response.fail("金额错误"); } if (param.getGoodsCount() <= 0){ return Response.fail("数量错误"); } return Response.success(); }当我们有了全局异常处理后,这边就直接可以抛出自定义的异常了,代码看起来会简洁一些。
public Response createOrder(CreateOrderParam param) { paramsCheck(param); ........... } private void paramsCheck(CreateOrderParam param) { if (param.getTotalPrice() <= 0){ throw new BizException( ResponseCode.PARAM_ERROR_CODE, "金额错误"); } if (param.getGoodsCount() <= 0){ throw new BizException( ResponseCode.PARAM_ERROR_CODE, "数量错误") } }业务层的异常跑出去后,在全局异常中会进行处理成固定的格式,然后返回给调用方。像很多开放平台的 API 都会有很多的 code 来表示不同的异常类型。
内部服务层内部服务层也就是说内部服务之间的调用,比如我们用 Dubbo, 如果被调用的服务中没有进行全局异常处理,那么当调用的某个接口报错的时候,调用者这边就会直接报错。
如果我们想就算报错了,调用方这边还是能够获取到正常的响应内容,只不过是内容中会告诉我这个请求是成功的还是失败的。
比如下面的远程调用,如果有全局异常处理,那么就可以根据响应判断是否成功,如果没有的话就直接报错了,如果需要对错误进行处理,还得捕获异常进行处理。
ResponseData<UserResponse> user = userRemoteService.getUser(userId); if(user.isSuccess()) { ....... } 全局异常处理 Http 全局异常处理关于 Http 的全局异常处理,这边就不细讲了,大家可以查看我的这篇文章:https://mp.weixin.qq.com/s/sIkrZTzGP4caKHzKYKqT7A
处理后如果有报错,那么返回的也是固定的数据格式:
{ code: 500, message: "/ by zero", data: null, domain: "kitty-cloud-article-provider", errors: null, requestId: "52a9f30323e80d82", success: false } Rpc(Dubbo)全局异常处理Dubbo 的全局异常处理可以通过 Filter 进行处理,获取执行的结果去进行处理,如果有异常信息就将相应的内容改成统一的失败格式进行返回。
需要注意的是要将 Result 中的 Exception 设置为 null, 因为 Dubbo 内部的 org.apache.dubbo.rpc.filter.ExceptionFilter 也会对异常进行处理,移除掉后 ExceptionFilter 就不会执行对应的逻辑了。
Dubbo 处理后的效果也是会返回固定格式,如下: