springboot中过滤器配置使用

前置介绍

你使用

• java
• springboot

过滤器 filter 用在请求到达 controller 之前或者响应返回给用户之前

往往可以用 filter 来做请求的修改，日志、权限、跨域等场景，例如：设置编码和字符集，请求头，状态码等

过滤器是在请求进入容器后，但请求进入 servlet 之前进行预处理的，请求结束返回也是，是在 servlet 处理完后，返回给前端之前

拦截器可以获取 IOC 容器中的各个 bean，而过滤器就不行，在拦截器里注入一个 service，可以调用业务逻辑。而过滤器是 JavaEE 标准，只需依赖 servlet api ，不需要依赖 spring

Filter 是依赖于 Servlet 容器，属于 Servlet 规范的一部分，Filter 的生命周期由 Servlet 容器管理

filter 代码

doFilter 方法中做过滤的逻辑

public class FirstFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化时执行的代码
        System.out.println("FirstFilter initialized");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 在请求到达 Controller 之前执行的
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        System.out.println("Request URL: " + httpRequest.getRequestURL());

        // 执行后续的过滤器或 Controller
        chain.doFilter(request, response);

        // 在响应返回客户端之前执行的代码
        System.out.println("Response processed");
    }

    @Override
    public void destroy() {
        // 销毁时执行的代码
        System.out.println("FirstFilter destroyed");
    }
}

注册 filter

下面两个方法都可以

方法一：@WebFilter注解（Servlet 3.0+）
如果你的项目支持 Servlet 3.0 及以上版本，可以直接在 Filter 类上使用 @WebFilter 注解

@WebFilter(urlPatterns = "/api/*")
public class FirstFilter implements Filter {
	// ...
}

在 Spring Boot 启动类上添加 @ServletComponentScan,使 @WebFilter 生效

@SpringBootApplication
@ServletComponentScan // 扫描@WebFilter注解

那怎么知道自己是不是 servlet 3.0 以及以上版本？
Spring Boot 的版本和嵌入的 Tomcat 版本决定了默认使用的 Servlet API 版本

• Spring Boot 2.x 对应 Tomcat 9.x，支持 Servlet 4.0。
• Spring Boot 3.x 对应 Tomcat 10.x，支持 Servlet 5.0（Jakarta EE）
  你还可以查找使用的 javax.servlet-api 依赖是哪个版本的

方法二：通过配置 configuration 和 bean 注册

@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<FirstFilter> FirstFilter() {
        FilterRegistrationBean<FirstFilter> registrationBean = new FilterRegistrationBean<>();
        registrationBean.setFilter(new FirstFilter());
        registrationBean.addUrlPatterns("/api/*"); // 指定过滤器的URL模式
        return registrationBean;
    }
}

疑问

过滤器的执行顺序？
如果你只使用 FilterRegistrationBean 显示注册 filter，则使用如下方法指定优先级

registrationBean.setOrder(1);

如果你是多个 filter 使用 @WebFilter 注解，它们的执行顺序由类名的字母顺序决定（在 @WebFilter 注解中添加 @Order 注解（如 @Order(1)）不会生效。因为 @Order 是 Spring 的注解，而 @WebFilter 是 Servlet 原生注解，Spring 不会自动将其顺序应用到 Servlet 容器中）
你可以结合 @WebFilter 和 FilterRegistrationBean 使用，即 FilterRegistrationBean 再覆盖顺序，需要使用其 setOrder
如果需要精确控制顺序，推荐完全使用 FilterRegistrationBean 注册过滤器（无需 @WebFilter）