Spring boot项目中异常拦截设计和处理详解

背景：

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

• 业务流程分析疏漏，对业务流程的反向操作、边界分析设计不充分
• 调用外部服务、调用外部系统出现的超时、错误、返回值与预期不符
• 外部资源连通性问题，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

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