Kitty Cloud(HTTP/RPC)的全局异常处理

项目地址

https://github.com/yinjihuan/kitty-cloud[1]

异常处理不用我讲，大家都清楚。单独的异常处理太繁琐，全局异常处理可以在一个应用中统一进行异常的处理，非常方便。目前全局异常处理用的也越来越广泛，今天跟大家来聊一聊 Kitty Cloud 中的全局异常是如何处理的？

为什么要使用全局异常处理呢？

使用全局异常处理后，我们不需要定义固定类型的返回值，当业务代码报错的时候直接通过异常处理方式来返回给前端或者 API 调用方错误信息。

不使用全局异常处理案例

Web 层

比如我们定义了一个 ResponseData 用来返回固定格式的数据，正常情况下不会有问题，给前端返回的格式也是固定的，如下：

代码语言：javascript复制

{
  "code":200,
  "data":{
    "name":"yinjihuan"
  },
  "message":"success",
}

如果业务发生异常，那么这个接口就不会返回上面那样固定格式的数据了，会给我们返回错误页面。除了代码异常还有一种情况就是当访问的 Uri 错误的时候，也会给调用方返回 404 的错误页面，如下：

如果是传统的 Web 项目，里面包含了页面这是没问题的，我们也可以自定义错误页面让用户体验更好一点。但是在这个基本上是前后端分离的开发模式下，后端只提供的数据的 API，不会有页面的内容。所以就算出错了，就算使用者调用的 API 路径错了，也应该返回固定的格式，并且告诉调用方路径错了。所以我们需要全局的异常处理。

业务层

在业务层最常见的用法就是我们可以直接抛出自定义异常，这样在全局异常处理后给调用方返回的还是固定的格式，如果没有全局异常处理，我们可能会用固定的 Response 来做这件事，比如下面的代码：

代码语言：javascript复制

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();
}

当我们有了全局异常处理后，这边就直接可以抛出自定义的异常了，代码看起来会简洁一些。

代码语言：javascript复制

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, 如果被调用的服务中没有进行全局异常处理，那么当调用的某个接口报错的时候，调用者这边就会直接报错。

如果我们想就算报错了，调用方这边还是能够获取到正常的响应内容，只不过是内容中会告诉我这个请求是成功的还是失败的。

比如下面的远程调用，如果有全局异常处理，那么就可以根据响应判断是否成功，如果没有的话就直接报错了，如果需要对错误进行处理，还得捕获异常进行处理。

代码语言：javascript复制

ResponseData<UserResponse> user =
                        userRemoteService.getUser(userId);
if(user.isSuccess()) {
  .......
}

全局异常处理

Http 全局异常处理

关于 Http 的全局异常处理，这边就不细讲了，大家可以查看我的这篇文章：《最佳实践 - API 错误处理》https://mp.weixin.qq.com/s/sIkrZTzGP4caKHzKYKqT7A

处理后如果有报错，那么返回的也是固定的数据格式：

代码语言：javascript复制

{
  code: 500,
  message: "/ by zero",
  data: null,
  domain: "kitty-cloud-article-provider",
  errors: null,
  requestId: "52a9f30323e80d82",
  success: false
}