@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我尝试了如下几种情况

Filter 实现类 + @WebFilter + @ServletComponentScan：正常urlpattern的Filter
Filter 实现类 + FilterRegistrationBean构造 + @Configuration：正常urlpattern的Filter，并且可以设置Order
仅仅 Filter实现类 + @Component ：会注册一个urlpattern 为 /*的过滤器
通过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<Class<?>, ServletContextInitializer> initializers 中

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