Springboot项目中异常拦截设计与处理

背景:

项目运行过程中会出现各种各样的问题,常见的有以下几种情况:

  1. 业务流程分析疏漏,对业务流程的反向操作、边界分析设计不充分

  2. 调用外部服务、调用外部系统出现的超时、错误、返回值与预期不符

  3. 外部资源连通性问题,db等服务器出现的网络抖动或宕机

无论是分析设计、开发、测试、线上都需要能够准确定位问题并制定解决方案。

目的:

  • 规范化异常的处理过程,避免异常被吞和到处都在捕获异常的情况

  • 准确的反馈异常信息,为定位问题提供依据

  • 通用性异常全局处理,降低业务开发关注度 

  • 对异常情况进行预警,以便能够及时响应

一、异常规划

1. 业务类异常

造成业务流程不能正确执行的行为,常见的几种:

  • 输入必填验证

  • 业务状态约束校验

  • 权限验证

  • 调用外部服务返回数据不符合预期

这类异常需要给调用方返回明确的异常描述信息,一般情况下和代码无关,无需调整编码

注:是业务完整性的一部分,需提前分析

2. 系统类异常

  • 服务调用异常: 超时、中断、接口异常(非200请求)

  • 第三方异常 :db\redis\消息队列 连接失败等

注:通常与业务流程无关,与第三方系统有关,不能简单的通过调整代码解决

3. 通用异常

编码不严谨、数据异常造成的问题,不可预测

举例:参数类型不匹配、空指针、数组越界

二、异常拦截

在springboot中全局异常拦截处理已知的有下面2种方案:

方案1:@ControllerAdvice、实现ErrorController

      注:利用springboot自带的拦截机制,只需要定义出处理的策略,没有破坏springboot的约定

方案2:继承AbstractHandlerExceptionResolver,完全自定义处理策略

      注:使用spring中最底层的类,打破了springboot的约定,能够拦截到所有异常

 

三、方案实践

 笔者基于方案一进行实践。

1. 异常拦截时序图

 

 

2. RrcRestAdvice实现代码

2. RrcExpHandler实现代码

注意:基于RestControllerAdvice的异常拦截只能捕获请求达controller之后的程序异常,所以需要实现ErrorController处理之前的异常。

 

总结:

推荐基于springboot中@ControllerAdvice 和 ErrorController接口的约定,相对较符合springboot的约定。

其他可选方案:

继承AbstractHandlerExceptionResolver

优点:可完全自定义处理策略。缺点:对框架约定破坏较为严重,自定义处理策略容易疏漏。

继承HandlerInterceptorAdapter

理论上可以处理业务代码抛出的异常,优缺点没有进行过验证。