Spring HandlerInterceptor工作机制

本文以一个通过正常注册拦截器流程注册拦截器失败的实际场景，来带领大家阅读源码，体会Spring的HandlerInterceptor拦截器整个工作流程

简单认识#

org.springframework.web.servlet.HandlerInterceptor是Spring框架中的一个接口，用于拦截处理程序（Handler）的请求和响应。它允许开发人员在请求处理程序执行之前和之后执行自定义的预处理和后处理逻辑。 HandlerInterceptor接口定义了三个方法：

preHandle：在请求处理程序执行之前调用。可以用于进行权限验证、日志记录等操作。如果该方法返回false，则请求将被中断，后续的拦截器和处理程序将不会被执行。
postHandle：在请求处理程序执行之后、视图渲染之前调用。可以对请求的结果进行修改或添加额外的模型数据。
afterCompletion：在整个请求完成之后调用，包括视图渲染完毕。可用于进行资源清理等操作。通过实现HandlerInterceptor接口，可以自定义拦截器，并将其注册到Spring MVC的配置中。拦截器可以拦截指定的URL或者所有请求，并在请求的不同阶段执行相应的逻辑。

正常的拦截器注册流程#

定义一个拦截器，实现org.springframework.web.servlet.HandlerInterceptor接口

如：

public class LoginInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
	// ...
        return true;
    }
   
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable ModelAndView modelAndView) throws Exception {
        // ...
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable Exception ex) throws Exception {
    	// ...
    }
}

定义配置类，实现WebMvcConfigurer，实现addInterceptors进行拦截器注册

@Configuration(proxyBeanMethods = false)
public class WebMvcConfiguration implements WebMvcConfigurer {


    @Override
    public void addInterceptors(InterceptorRegistry registry) {
    	
    	// ...

        registry.addInterceptor(new LoginInterceptor())
            .addPathPatterns(HOTSWAP_ALL_SERVICE)
            .addPathPatterns(hsAddPaths)
            .excludePathPatterns(commonExcludePaths);
            
        // ...

    }
}

而有时候通过这种方式注册不成功。

我们先来说一下说一下HandlerInterceptor的工作机制。首先以上描述的是拦截器的注册过程。

然后再来看一下注册的拦截器存储在哪里，以及如何被使用的。

存储已注册拦截器的位置#

查看接口方法org.springframework.web.servlet.config.annotation.WebMvcConfigurer#addInterceptors的调用之处，位于类org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration里面，其是WebMvcConfigurationSupport的子类

WebMvcConfigurationSupport的一个子类，它检测并委托给所有WebMvcConfigurer类型的bean，允许它们自定义WebMvcConfigurationSupport提供的配置。这是@EnableWebMvc实际导入的类。

org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration#addInterceptors方法：

@Override
protected void addInterceptors(InterceptorRegistry registry) {
   this.configurers.addInterceptors(registry);
}

可以看出，这是从我们注册的WebMvcConfigurer实现类中，通过传入的InterceptorRegistry实例搜集拦截器，而调用该方法的地方位于

org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#requestMappingHandlerMapping，实际是其默认子类DelegatingWebMvcConfiguration进行注册RequestMappingHandlerMapping bean 的行为，在其方法中调用了org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#getInterceptors方法，解析InterceptorRegistry里面添加的拦截器。

org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#getInterceptors

* Provide access to the shared handler interceptors used to configure
 * {@link HandlerMapping} instances with.
 * This method cannot be overridden; use {@link #addInterceptors} instead.
 */
protected final Object[] getInterceptors(
      FormattingConversionService mvcConversionService,
      ResourceUrlProvider mvcResourceUrlProvider) {
   if (this.interceptors == null) {
      InterceptorRegistry registry = new InterceptorRegistry();
      addInterceptors(registry);
      registry.addInterceptor(new ConversionServiceExposingInterceptor(mvcConversionService));
      registry.addInterceptor(new ResourceUrlProviderExposingInterceptor(mvcResourceUrlProvider));
      // 排序
      this.interceptors = registry.getInterceptors();
   }
   return this.interceptors.toArray();
}

整个过程就是，WebMvcConfigurationSupport在注册RequestMappingHandlerMapping时候，会创建一个InterceptorRegistry实例，被传入了org.springframework.web.servlet.config.annotation.DelegatingWebMvcConfiguration#addInterceptors方法，进而传入了org.springframework.web.servlet.config.annotation.WebMvcConfigurerComposite#addInterceptors方法，最后被每个WebMvcConfigurer的实现类的addInterceptors方法所接收，用于搜集用户自定义的拦截器注册。即帮助配置映射拦截器列表。

注册失败原因#

我们来看一下下面这个注册失败的场景：

@Configuration
@ConditionalOnProperty(name = "spring.mvc.configuration.custom", havingValue = "false", matchIfMissing = true)
public class CustomSpringMvcConfiguration extends WebMvcConfigurationSupport {
	// ...
}

原因是一个公共的jar包注册了一个的子类，导致默认的注册子类DelegatingWebMvcConfiguration没有被注册，而其对方法的重写，也没有复写DelegatingWebMvcConfiguration的默认实现。

@Override
protected void addInterceptors(InterceptorRegistry registry) {
    if (auditTrailLogInterceptor != null) {
        registry.addInterceptor(auditTrailLogInterceptor).addPathPatterns("/**");
        log.info("已註冊 AuditTrailLog 攔截器");
    }
    if (openApiLogInterceptor != null) {
        registry.addInterceptor(openApiLogInterceptor).addPathPatterns("/**");
        log.info("已註冊 openApiLog 攔截器");
    }
    super.addInterceptors(registry);
}

其中

super.addInterceptors(registry);

是个无效的语句，因为父类是一个空实现。相当于文首的注册拦截器方法被堵死了，迫于无法直接修改jar包的情况，我们只能另寻方法。

初步尝试#

由于所有注册的拦截器，最终都是放在org.springframework.web.servlet.handler.AbstractHandlerMapping#interceptors中，所以我们要想办法拿到AbstractHandlerMapping的注册bean，即上面提到的org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport#requestMappingHandlerMapping方法注册的bean，然后将我们的拦截器注册并放置进去。

既然上述注册方法行不通，那么我们的配置类就无需实现WebMvcConfigurer接口了。

我们需要重写一个配置类，注入RequestMappingHandlerMapping对象，然后进行手动注册。直接在构造函数中注册。

@Configuration(proxyBeanMethods = false)
public class WebMvcConfiguration {


    public WebMvcConfiguration(
        @Qualifier("requestMappingHandlerMapping") RequestMappingHandlerMapping mapping) {

        // 反射拿到已經註冊的攔截器集合
        List