项目地址
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 处理后的效果也是会返回固定格式,如下:
关于作者:尹吉欢,简单的技术爱好者,《Spring Cloud 微服务-全栈技术与案例解析》, 《Spring Cloud 微服务 入门 实战与进阶》作者, 公众号 猿天地 发起人。个人微信 jihuan900, 欢迎勾搭。