@WebFilter两种使用方法和失效解决方案

1、直接使用过滤器不会生效@WebFilter(urlPatterns="/dd/*", filterName=“loginFilter”)
需要在springboot启动类上加上@ServletComponent注解才会生效（无法设置Filter顺序）

/**  
 * @author nineee
 * @description urlPatterns:拦截的url地址 
 *              filterName:拦截器名称
 * @date 2020/8/31 16:09
 */
@Slf4j
@WebFilter(urlPatterns="/dd/*", filterName="loginFilter")
public class LoginFilter implements Filter{
 
  /*
   * 容器加载完成调用
   * */
  @Override
  public void init(FilterConfig filterConfig) throws ServletException {
    log.info("LoginFilter.init");
  }
 
  /*
   *  请求被拦截的时候调用
   * */
  @Override
  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
      throws IOException, ServletException {
    log.info("LoginFilter.doFilter");
    HttpServletRequest req = (HttpServletRequest)request;
    HttpServletResponse resp = (HttpServletResponse)response;
    chain.doFilter(request, response);
  }
 
  /*
   * 容器被销毁的时候调用
   * */
  @Override
  public void destroy() {
    System.out.println("filter destroy...");
  }
}

@SpringBootApplication
@ServletComponentScan
public class NineeeStart {
    public static void main(String[] args) {
        SpringApplication.run(NineeeStart.class, args);
    }
}

2、手动配置bean（推荐这种方式，可以在FilterRegistrationBean里设置Order）

不需要@WebFilter注解

/**
 * @author nineee
 * @description urlPatterns:拦截的url地址
 *              filterName:拦截器名称
 * @date 2020/8/31 16:09
 */
@Slf4j
public class LoginFilter implements Filter{
 
  /*
   * 容器加载完成调用
   * */
  @Override
  public void init(FilterConfig filterConfig) throws ServletException {
    log.info("LoginFilter.init");
  }
 
  /*
   *  请求被拦截的时候调用
   * */
  @Override
  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
      throws IOException, ServletException {
    log.info("LoginFilter.doFilter");
    HttpServletRequest req = (HttpServletRequest)request;
    HttpServletResponse resp = (HttpServletResponse)response;
    chain.doFilter(request, response);
  }
 
  /*
   * 容器被销毁的时候调用
   * */
  @Override
  public void destroy() {
    System.out.println("filter destroy...");
  }
}

@Configuration
public class WebAuthFilterConfig {
 
    @Bean
    public FilterRegistrationBean webAuthFilterRegistration() {
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(loginFilter());
        registration.setName("LoginFilter");
        registration.addUrlPatterns("/spu/*");
//        registration.addInitParameter("excludeUrls", "/web/login");
        registration.setOrder(0);
        return registration;
    }
 
    @Bean
    public Filter loginFilter() {
        return new LoginFilter();
    }
}

3、网上有的加上@Component注解@Configuration注解过滤器会生效，url会匹配全部，原因得去扒源码看。也可以看这篇的大致介绍：

@WebFilter 的使用及采坑 - 木西-Muxy - 博客园 (cnblogs.com)https://www.cnblogs.com/muxi0407/p/11950627.html我尝试了如下几种情况

1. Filter 实现类 + @WebFilter + @ServletComponentScan：正常urlpattern的Filter
2. Filter 实现类 + FilterRegistrationBean构造 + @Configuration：正常urlpattern的Filter，并且可以设置Order
3. 仅仅 Filter实现类 + @Component ：会注册一个urlpattern 为 /*的过滤器
4. 通过1、2、3可以得知，只要在Filter实现类上增加 @Component ，就会导致 1个正常urlpattern的filter+1个拦截/*的filter（由于@Component注解导致）

我们先来看一下情况1中 @WebFilter + @ServletComponentScan 的解析和注册原理

首先，很快可以找到解析并处理 @ServletComponentScan的Class 

可以看到，每个 @WebXXX 注解都有一个显示的 handler类处理，这里我们看下Filter相关的

 实际上最终他也是使用了 FilterRegistrationBean用来注册Filter，并填充了相对应的属性，但同时也没有设置Order，所以他也是优先级最低，和下文中提到的@Component注解Filter一致。

 4、具体原理说明

接下来，我们来看【有的加上@Component注解@Configuration注解过滤器会生效，url会匹配全部】的具体原因，查看关键类：ServletContextInitializerBeans，看名字就知道，这个类收集了所有ServletContextInitializer的bean列表，而这个接口的实现

 就是所有可以注册Filter、servlet、Listener的 RegistrationBean。

与此同时，ServletContextInitializerBeans的构造函数中做了几件事：

 1、将各个RegistrationBean 放入 MultiValueMap, ServletContextInitializer> initializers 中

 2、addAdaptableBeans 方法是上面提到的 增加@Component注解后，就会增加一个 urlpattern 为/* 的filter的元凶了，拿Filter来举例，首先，它会获取所有实现Filter类的Bean集合，并通过FilterRegistrationBeanAdapter中的createRegistrationBean方法 创建一个新的 FilterRegistrationBean，并把Filter的Bean当成构造函数进行初始化，可以看到他并未设置FilterRegistrationBean中的其它Filter属性，比如urlPatterns 都为空。

 

 

可以看到，通过这种方式添加的filter 的order 顺序都是最低的

 3、最后，将1与2中的所有ServletContextInitializer 实例通过Order等排序手段放入 List sortedList中，ServletContextInitializerBeans构造完成。

4、接下来我们来看下 ServletContextInitializerBeans 是在什么时候进行调用的，经过一系列的debug和搜索后锁定了 ServletWebServerApplicationContext，介绍：

(1425条消息) springboot之IOC容器ServletWebServerApplicationContext分析_wang0907的博客-CSDN博客https://blog.csdn.net/wang0907/article/details/117420601

 在 Spring容器启动后，调用了 refresh方法，接着createWebServer 、this.getSelfInitializer().onStartup(servletContext);、

 在这里，构造了上文中提到的ServletContextInitializerBeans，并通过ServletContextInitializerBeans的迭代器获取了所有  ServletContextInitializer 实例，可以看到正是获取了上文中提到的sortedList

 最后通过调用每个 ServletContextInitializer 实例的 onstartup方法，进行了 Filter 的注册

 

进入了  FilterRegistrationBean的父类 AbstractFilterRegistrationBean 的 configure方法

 

 可以明显看到 当 servletname 和 urlpatterns 为空时，使用了 默认值 DEFAULT_URL_MAPPINGS，而这个默认值 正是

 后续就是正常配置filter的逻辑了

完。