SpringBoot对Filter过滤器中的异常进行全局处理

前言

今天处理拦截器中的异常时，遇到这样一个问题，我们希望在过滤器中对用户的请求进行判断，如果不符合要求直接抛出异常并在前端展示。但是如果我们直接在过滤器中throw一个异常时，尽管我们使用@ControllerAdvice和 @ExceptionHandler注解注册了全局异常处理器，但是前端是无法接收到的。

这是因为过滤器是在进入Servlet之前处理请求的，从注解名称也能看出来@ControllerAdvice是处理Controller层异常的，请求还没到Controller层，当然无法处理了。

那么如何将过滤器中的异常像Controller层一样进行全局处理呢？

一、全局异常处理

首先全局异常处理器还是不可少的，大概像下面这个样子

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(value = ServiceException.class)
    @ResponseBody
    public ResponseEntity<AjaxResponse> serviceExceptionHandler(ServiceException e, HttpServletRequest request){
        //...处理一些逻辑
        return new ResponseEntity<>(new AjaxResponse().failure(Constants.ErrorCode.SERVICE_ERROR,e.getMessage()), HttpStatus.BAD_REQUEST);
    }
}
1
2
3
4
5
6
7
8
9

二、处理过滤器中的异常

在我们自定义的Filter类中，使用HandlerExceptionResolver的resolveException方法来进行处理，如下面代码所示

@Component
public class MyFilter implements Filter {

    @Override
    public void init(javax.servlet.FilterConfig filterConfig) throws ServletException {
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
            //...进行一些逻辑处理
        	if (...) {
                HandlerExceptionResolver handlerExceptionResolver = SpringContextUtil.getBean("handlerExceptionResolver");
                handlerExceptionResolver.resolveException((HttpServletRequest) servletRequest, (HttpServletResponse) servletResponse,
                        null,new ServiceException("抛出过滤器全局异常!"));
                return;
            }
        filterChain.doFilter(servletRequest, servletResponse);
    }

    @Override
    public void destroy() {

    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

这样就能实现效果了：

看一下后端返回的响应数据如下：

接着我们说说HandlerExceptionResolver和它的resolveException方法的原理实现。

HandlerExceptionResolver 接口是 Spring MVC 提供的全局异常处理机制的一部分，它的原理基于 Spring MVC 框架的请求处理流程和异常处理机制。

当请求在 Spring MVC 中的某一组件中抛出异常时，异常会沿着请求处理的链路向上传播，直到找到能够处理异常的地方。通常，异常首先会被容器（例如，Servlet 容器）捕获，然后传递给 Spring MVC 框架。Spring MVC 框架会遍历已注册的异常处理器，调用它们的 resolveException 方法。每个异常处理器有机会检查异常类型，如果匹配，就执行自定义的异常处理逻辑。

在SpringBoot中我们通过 @ControllerAdvice 注解和 @ExceptionHandler注解注册了全局异常处理器，因此resolveException方法会将异常进行传播给我们自定义的异常处理器，最后就能进行全局异常处理了。