SpringBoot - OncePerRequestFilter的使用场景

最新推荐文章于 2025-10-18 18:20:12 发布

原创

最新推荐文章于 2025-10-18 18:20:12 发布 · 1.6w 阅读

48 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot

OncePerRequestFilter是Spring提供的一种过滤器实现，确保外部请求只执行一次过滤逻辑，避免服务器内部forward导致的重复过滤。本文介绍了过滤器的基本概念，OncePerRequestFilter的工作原理，以及如何在实际项目中使用它来处理JWT认证。同时，展示了如何通过配置使其在多过滤器环境中按指定顺序执行。

写在前面

OncePerRequestFilter类是一个实现了javax.servlet.Filter原生接口的抽象类。OncePerRequestFilter可以保证一次外部请求，只执行一次过滤方法，对于服务器内部之间的forward等请求，不会再次执行过滤方法。

什么是过滤器

在这里插入图片描述
在讲解"OncePerRequestFilter"前，我们先看一下过滤器是什么？

A. 过滤器在WEB应用启动时初始化一次, 在WEB应用停止时销毁；
B. 可以对请求的URL进行过滤, 对敏感词过滤；
C. 过滤器将处理逻辑挡在拦截器的外面；
D. 过滤器实现的是 javax.servlet.Filter原生接口，过滤器是SERVLET 规范的一部分；
E. 过滤器在请求进入WEB容器后，到达SERVLET之前进行过滤器的逻辑处理；
F. 过滤器依赖WEB容器，也会被多次执行。
G. 过滤器的作用就是在业务逻辑执行前/后对请求和响应进行相应的处理，如果能配合HttpServletRequestWrapper和HttpServletResponseWrapper使用更加完美。

什么是单次过滤器

使用场景

OncePerRequestFilter的主要目的是为了兼容不同的WEB容器，因为Servlet版本不同，执行的过程也不同，其实不是所有的容器一次请求只过滤一次。

源码分析

public abstract class OncePerRequestFilter extends GenericFilterBean {
   
   
     
    ...
    
    public final void doFilter(ServletRequest request, ServletResponse response, FilterChain filterChain) throws ServletException, IOException {
   
   
        if (request instanceof HttpServletRequest && response instanceof HttpServletResponse) {
   
   
            HttpServletRequest httpRequest = (HttpServletRequest)request;
            HttpServletResponse httpResponse = (HttpServletResponse)response;
            
            // 获取是否执行过滤方法的一个属性KEY，作为是否执行过滤方法的一个标记