Spring: OncePerRequestFilter

文章目录

• 一、介绍
• 二、使用

一、介绍

OncePerRequestFilter属于Spring Boot的过滤器组件家族，并已在Spring Security框架中被广泛应用。该组件的主要功能是保证每次外部请求只会触发一次过滤操作；而对于内部接口的转发请求（如forward等），则不会重复触发此过滤机制。

该系统的开发目的是为了实现对多种Web服务器环境的支持，在实际应用中，并非所有服务器会在单次请求内仅进行一次过滤操作。不同版本的Servlet可能会影响到其执行流程的具体表现。

在实际应用中, 建议继承OncePerRequestFilter类并自定义doFilterInternal方法以确定具体的过滤策略. 当一个RequestDispatcher将请求转发至一个ServletContext时, 该Dispatcher可能会将请求转发至另一个ServletContext. 由于OncePerRequestFilter的存在性, 可以确保每个请求只会被过滤一次.

此外，在此过滤器中还包含了一个enabled属性（英文：enabled），用于决定是否启用该拦截器实例（英文：instance）。在默认情况下（英文：by default），enabled属性设为true（英文：true），表示该拦截器处于启用状态（英文：