Spring Boot拦截器不生效

初步现象

新建的Spring Boot拦截器不生效

初步排查

- 排查拦截器是否注册
- 拦截器的excludePathPatterns等属性是否设置正确
这些都没问题，进行下一步排查

进一步排查

debug DispatchServelt，查看拦截器是否存在handler中
结果发现存在两个RequestMappingHandlerMapping实例，其中一个包含新建的拦截器，另一个没有任何拦截器

深入为什么存在两个RequestMappingHandlerMapping实例

• RequestMappingHandlerMapping什么时候初始化
  • 是在WebMvcAutoConfiguration中初始化，并且只会初始化一次
• RequestMappingHandlerMapping什么时候添加拦截器
  • RequestMappingHandlerMapping在初始化时，会获取当前环境下的所有拦截器，并写入到自己的变量中

由此可见，有一个 RequestMappingHandlerMapping是通过非正常的方式来生成的，使用的spring boot，应用启动时会通过WebMvcAutoConfiguration来生成一个RequestMappingHandlerMapping实例，那另一个是哪里生成的？

最后发现是在有一个xml配置文件，有下面一条语句：

<mvc:annotation-driven/>

使用了mvc:annotation-driven后，默认会帮我们注册默认处理请求处理器
到这里问题就已经找到了

总结

在spring boot框架下，应用会自动生成一个RequestMappingHandlerMapping实例，这个实例会获取当前环境下的所有拦截器，并写入到自己的变量中，而 mvc:annotation-driven 则会注册默认处理请求处理器，导致存在多个RequestMappingHandlerMapping，造成了冲突