springboot 拦截器 过滤器

### Spring Boot 拦截器与过滤器的用法及区别 #### 一、概念介绍 - **拦截器（Interceptor）** 是一种基于 Java 的反射机制，在 AOP 编程中的体现之一。它主要用于拦截用户的请求并对其进行预处理和后处理操作[^1]。 - **过滤器（Filter）** 则是由 Servlet 容器提供的一种技术，能够对所有的 HTTP 请求和响应进行拦截，并对其内容或头信息进行修改[^5]。 #### 二、核心区别 | 特性 | 拦截器（Interceptor） | 过滤器（Filter） | |---------------------|---------------------------------------------|------------------------------------------| | **触发时机** | 只能拦截 Controller 处理的请求 | 能够拦截所有经过容器的请求 | | **依赖关系** | 需要依赖于 Spring MVC | 不依赖任何框架，属于 Servlet API | | **访问上下文** | 可以获取到更多的 Spring 上下文中对象 | 主要是针对 HttpServletRequest 和 HttpServletResponse 对象的操作 | | **灵活性** | 更加灵活，适合复杂的业务逻辑 | 较为简单，适用于简单的请求/响应处理 | 上述差异决定了它们在实际开发中的不同用途[^2]。 #### 三、使用场景 ##### 1. 拦截器的典型应用 - 用户权限校验：通过 `preHandle` 方法判断当前用户是否有权访问目标资源[^4]。 - 日志记录：记录请求参数、返回数据等信息以便后续分析。 - 数据转换：统一处理入参或者出参的数据格式。 ##### 2. 过滤器的典型应用 - 字符编码设置：解决中文乱码问题。 - XSS 攻击防护：过滤掉恶意脚本注入的内容。 - 性能监控：统计接口调用耗时情况。 #### 四、实现步骤 以下是两种组件的具体创建与配置方式： ##### （1）拦截器的创建与配置 ```java // 创建自定义拦截器类 public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token = request.getHeader("Authorization"); if (token != null && validateToken(token)) { // 假设有一个验证方法 return true; } response.setStatus(HttpServletResponse.SC_UNAUTHORIZED); return false; // 如果未通过认证，则阻止继续执行 } private boolean validateToken(String token){ // 实际验证逻辑省略... return !token.isEmpty(); } } ``` 接着注册此拦截器至全局配置中： ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Bean public AuthInterceptor authInterceptor(){ return new AuthInterceptor(); } @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(authInterceptor()) .addPathPatterns("/api/**") // 应用路径模式匹配规则 .excludePathPatterns("/api/login"); // 排除某些不需要拦截的 URL } } ``` ##### （2）过滤器的创建与配置 编写一个标准的 Filter 类型 Bean 并将其加入到应用程序生命周期里去工作： ```java @Component public class EncodingFilter extends OncePerRequestFilter { @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { response.setContentType("text/html;charset=UTF-8"); request.setCharacterEncoding("UTF-8"); filterChain.doFilter(request,response); // 继续传递给下一个环节 } } ``` 以上代码片段展示了如何利用过滤器完成字符集调整的任务[^3]。 #### 五、执行顺序与流程 当客户端发起一次完整的 HTTP 请求到达服务端之后，整个过程会按照如下次序依次经历各个阶段： 1. 先由外部最外层的 Filters 开始逐级向下运行； 2. 当进入 DispatcherServlet 后再交予内部 Interceptors 来接管控制流； 3. 最终抵达具体的 Controllers 层面完成真正的业务计算部分后再原路返回向上走一遍相同的路径直到最后形成最终应答消息发送回前端浏览器显示出来为止。  #### 六、常见问题与解决方案 Q: 如何让我的过滤器优先于其他第三方库自带的那个生效？ A: 修改 bean definition order 或者直接指定 Order 注解数值即可达成目的。 ---

Spring Boot中的拦截器、过滤器和监听器都是用于处理请求和响应的组件，但它们在功能和使用方式上有一些区别。 拦截器（Interceptor）是Spring提供的一种机制，用于对请求进行预处理和后处理。拦截器可以拦截特定的URL请求，并在请求前后执行一些自定义的逻辑。拦截器基于Java的动态代理机制实现，可以在请求的处理过程中插入自定义的逻辑。拦截器通常用于进行身份验证、日志记录等通用处理。 过滤器（Filter）是Java Servlet规范提供的一种机制，用于对请求和响应进行过滤和修改。过滤器可以拦截所有的URL请求，并在请求前后对请求进行预处理和后处理。过滤器基于Java的回调函数机制实现，在请求进入Servlet容器之前和响应离开Servlet容器之前进行拦截和处理。过滤器通常用于请求解析、字符编码转换、跨域处理等通用处理。 监听器（Listener）是Java Servlet规范提供的一种机制，用于监听Web应用程序中事件的发生。监听器可以监听Servlet容器中的特定事件，如应用程序的初始化、销毁、会话的创建、销毁等。监听器基于Java的回调函数机制实现，可以在特定事件发生时执行自定义的逻辑。监听器通常用于应用程序的初始化、资源管理等操作。 在Spring Boot中，拦截器和过滤器可以直接在配置类中进行配置和注册，而监听器需要通过@WebListener注解或在配置类中手动注册。需要注意的是，拦截器、过滤器和监听器的执行顺序是不同的，拦截器在请求进入Controller之前执行，过滤器在请求进入Servlet容器之前执行，而监听器可以监听更多的事件，不仅限于请求和响应。 希望以上信息对你有所帮助！如果你有其他问题，请随时提问。