如何将Servlet Filter逻辑封装为Jar供Maven项目使用？添加后Filter未生效

以下是几个常见的排查方向和解决办法：

• Filter未被正确注册
  传统Web项目中，Jar包内的web.xml不会被主项目自动加载，别依赖它注册Filter。改用@WebFilter注解标注你的Filter类，同时在主项目的web.xml里补充对应的Filter配置；如果是Spring Boot项目，要么给Filter类加@Component注解，要么在主项目里用FilterRegistrationBean手动注册：

  @Configuration
  public class FilterConfig {
      @Bean
      public FilterRegistrationBean<LogFilter> logFilterRegistration() {
          FilterRegistrationBean<LogFilter> registration = new FilterRegistrationBean<>();
          registration.setFilter(new LogFilter());
          registration.addUrlPatterns("/*"); // 拦截所有请求
          registration.setOrder(1); // 数值越小，Filter优先级越高
          return registration;
      }
  }
  

• 组件扫描范围未覆盖Jar内的Filter
  主项目的组件扫描如果没包含Filter所在的包，Spring会找不到这个类。在Spring Boot主类上添加@ComponentScan(basePackages = {"你的Filter所在包", "主项目自身包路径"})，确保Jar内的Filter能被扫描实例化。

• 拦截路径配置错误
  检查@WebFilter的urlPatterns参数，比如如果只配置了/api/*但调用的接口是/admin/*，自然不会触发Filter。确保路径覆盖到目标接口，通用拦截所有请求的写法是/*。

• Jar包打包或依赖问题

  1. 解压Jar包检查：确认里面包含Filter的.class文件，避免打包时遗漏类文件。
  2. 调整依赖范围：如果主项目pom.xml中日志Jar的依赖范围设为provided，运行时主项目不会加载该Jar，改成compile即可。

• Filter优先级或冲突
  若主项目存在其他Filter，检查它们的order值，确保日志Filter的优先级更高（数值更小）。另外，排查是否有Filter在处理请求时，未调用chain.doFilter(request, response)就直接返回，导致后续Filter无法执行。

内容的提问来源于stack exchange，提问作者sam