Spring Boot拦截器Interceptor与过滤器Filter深度解析(区别、实现与实战指南)

2025-05-20 02:50
文章标签 java 实战 实现 深度 spring 区别 解析 boot 拦截器 过滤器 指南 filter interceptor

本文主要是介绍Spring Boot拦截器Interceptor与过滤器Filter深度解析(区别、实现与实战指南)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《SpringBoot拦截器Interceptor与过滤器Filter深度解析(区别、实现与实战指南)》：本文主要介绍SpringBoot拦截器Interceptor与过滤器Filter深度解析...

Spring Boot拦截器（Interceptor）与过滤器（Filter）深度解析：区别、实现与实战指南

一、核心概念对比

1. 本质区别

维度过滤器（Filter）拦截器（Interceptor）
规范层级Servlet规范（J2EE标准）Spring MVC框架机制
作用范围所有请求（包括静态资源）只处理Controller请求
依赖关系不依赖Spring容器完全集成Spring IOC容器
执行顺序最先执行（在DispatcherServlet之前）在DispatcherServlet之后执行
异常处理无法直接使用Spring的异常处理机制可以通过@ControllerAdvice统一处理

2. 执行流程示意图

HTTP Request
  ↓
Filter Chain（doFilter）
  ↓
DispatcherServlet
  ↓
Interceptor.preHandle
  ↓
Controller Method
  ↓
Interceptor.postHandle
  ↓
View Rendering（如有）
  ↓
Interceptor.afterCompletion
  ↓
Filter Chain（返回响应）

二、过滤器（Filter）开发指南

1. 基础实现方式

@Component
public class LogFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, 
                         FilterChain chain) throws IOException, ServletException {
        long startTime = System.currentTimeMillis();
        HttpServletRequest req = (HttpServletRequest) request;
        // 前置处理
        System.out.println("Request URI: " + req.getRequestURI());
        chain.doFilter(request, response); // 放行请求
        // 后置处理
        long duration = System.currentTimeMillis() - startTime;
        System.out.println("Request completed in " + duration + "ms");
    }
}

2. 高级配置技巧

@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<LogFilter> loggingFilter() {
        FilterRegistrationBeaandroidn<LogFilter> registration = new FilterRegistrationBean<>();
        registration.setFilter(new LogFilter());
        registration.addUrlPatterns("/api/*");
        registration.setOrder(Ordered.HIGHEST_PRECEDENCE); // 设置优先级
        return registration;
    }
}

典型应用场景：

  • 请求日志记录
  • 全局字符编码设置
  • 跨域处理（CORS）
  • XSS防御过滤
  • 请求内容压缩/解压

三、拦截器（Interceptor）开发指南

1. 标准实现模板

@Component
public class AuthInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, 
                           HttpServletResponse response, 
                           Object handler) throws Exception {
        String token = request.getHeader("Authorization");
        if (!validateToken(token)) {
            response.sendError(401, "Invalid token");
            return false; // 中断请求
        }
        return true;
    }
    @Override
    public void postHandle(HttpServletRequest request, 
                          HttpServletResponse response, 
                          Object handler,
                          ModelAndView modelAndView) throws Exception {
        // Controller方法执行后，视图渲染前
    }
    @Override
    public void afterCompletion(HttpServletRequest request, 
                               HttpServletResponse response, 
                               Object handler, 
                               Exception ex) throws Exception {
        // 请求完全结束后（包括视图渲染）
    }
}

2. 注册拦截器配置

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private AuthInterceptor authInterceptor;
    @Override
    public void addInterceptors编程(InterceptorRegistry registry) {
        registry.addInterceptor(authInterceptor)
                .addPathPatterns("/**")
                .excludePathPatterns("/login", "/public/**");
    }
}

典型应用场景：

  • 接口权限验证
  • 请求参数预处理
  • 接口耗时监控
  • 敏感操作日志
  • 数据绑定前校验

四、核心差异深度解析

1. 执行顺序对比实验

配置多个过滤器和拦截器时的执行顺序：

Filter1 → Filter2 → Interceptor.preHandle 
→ Controller 
→ Interceptor.postHandle 
→ Interceptor.afterCompletion 
→ Filter2 → Filter1

2. 异常处理差异

// 在过滤器中处理异常
public void doFilter(...) {
    try {
        chain.doFilter(request, response);
    } catch (Exception e) {
        response.sendError(500, "Server Error");
    }
}
// 在拦截器中处理异常
@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<?> handleException(Exception e) {
        return ResponseEntity.internalServerError().body("Error occurred");
    }
}

3. 异步请求处理

// 拦截器需实现AsyncHandlerInterceptor
@Override
public void afterConcurrentHandlingStarted(HttpServletRequest request, 
                                          HttpServletResponse response, 
                                          Object handler) {
    // 异步请求的特殊处理
}

五、最佳实践与选型策略

1. 技术选型决策树

是否需要处理静态资源？
├─ 是 → 必须使用Filter
└─ 否 → 
   是否需要访问Spring Bean？
   ├─ 是 → 选择Interceptor
   └─ 否 VPveqa→ 
      是否需要最早处理请求？
      ├─ 是 →China编程 选择Filter
      └─ 否 → 根据业务复杂度选择

2. 性能优化建议

  • 过滤器：避免在过滤器中做复杂业务逻辑
  • 拦截器：preHandle方法尽量轻量化
  • 两者都应避免：
    • 同步阻塞操作
    • 频繁的IO操作
    • 大对象的内存操作

3. 常见陷阱规避

  • 过滤器：
    • 忘记调用chain.doFilter()导致请求阻塞
    • 修改请求参数未使用Wrapper类
  • 拦截器：
    • 在postHandle中修改ModelAndView导致NPE
    • 异步请求中误用afterCompletion

六、实战案例演示

案例1：接口耗时监控系统

// 拦截器实现
public class MetricsInterceptor implements HandlerInterceptor {
    private static final ThreadLocal<Long> startTime = new ThreadLocal<>();
    @Override
    public boolean preHandle(...) {
        startTime.set(System.currentTimeMillis());
        return true;
    }
    @Override
    public void afterCompletion(...) {
        long duration = System.currentTimeMillis() - startTime.get();
        metricsservice.recordRequestTime(request.getRequestURI(), duration);
        startTime.remove();
    }
}

案例2：全局防重放攻击过滤器

public class ReplayAttackFilter implements Filter {
    private Cache<String, Boolean> requestCache = 
        Caffeine.newBuilder().expireAfterWrite(5, TimeUnit.MINUTES).build();
    @Override
    public void doFilter(...) {
        String nonce = request.getHeader("X-Nonce");
        if (requestCache.getIfPresent(nonce) != null) {
            response.sendError(400, "Duplicate request");
            return;
        }
        requestCache.put(nonce, true);
        chain.doFilter(request, response);
    }
}

七、扩展知识

1. 与AOP的区别

  • AOP：
    • 基于代理模式实现
    • 可以精确控制到具体方法
    • 更适合业务层面的切面处理
  • 拦截器：
    • 基于HandlerMapping实现
    • 主要针对HTTP请求生命周期
    • 更适合Web层通用处理

2. 高级应用场景

  • 过滤器链：实现责任链模式
  • 拦截器栈：组合多个拦截逻辑
  • 动态启用/禁用：结合配置中心实现

总结建议

  • 优先使用拦截器处理Web层通用逻辑
  • 保留过滤器用于底层请求处理
  • 复杂场景可以组合使用两者
  • 生产环境务必进行性能压测

通过合理运用过滤器和拦截器，开发者可以构建出高可维护性的Web应用架构。建议结合APM工具（如SkyWalking）监控两者的执行效率，持续优化系统性能。

到此这篇关于Spring Boot拦截器（Interceptor）与过滤器（Filter）深度解析：区别、实现与实战指南的文章就介绍编程到这了,更多相关Spring Boot拦截器与过滤器内容请搜索编程China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持China编程(www.chinasem.cn)！

这篇关于Spring Boot拦截器Interceptor与过滤器Filter深度解析(区别、实现与实战指南)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1154682。

相关文章

Java中流式并行操作parallelStream的原理和使用方法

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流（parallelStream）的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS
阅读更多...
C++中unordered_set哈希集合的实现

C++中unordered_set哈希集合的实现

《C++中unordered_set哈希集合的实现》std::unordered_set是C++标准库中的无序关联容器,基于哈希表实现,具有元素唯一性和无序性特点,本文就来详细的介绍一下unorder... 目录一、概述二、头文件与命名空间三、常用方法与示例1. 构造与析构2. 迭代器与遍历3. 容量相关4
阅读更多...
Java中Redisson 的原理深度解析

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、
阅读更多...
C++中悬垂引用(Dangling Reference) 的实现

C++中悬垂引用(Dangling Reference) 的实现

《C++中悬垂引用(DanglingReference)的实现》C++中的悬垂引用指引用绑定的对象被销毁后引用仍存在的情况,会导致访问无效内存,下面就来详细的介绍一下产生的原因以及如何避免,感兴趣... 目录悬垂引用的产生原因1. 引用绑定到局部变量，变量超出作用域后销毁2. 引用绑定到动态分配的对象，对象
阅读更多...
SpringBoot基于注解实现数据库字段回填的完整方案

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代
阅读更多...
一篇文章彻底搞懂macOS如何决定java环境

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面：本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一：使用 which命令方法二：使用 Java_home工具（Apple 官方推荐）那问题来了，
阅读更多...
JDK21对虚拟线程的几种用法实践指南

JDK21对虚拟线程的几种用法实践指南

《JDK21对虚拟线程的几种用法实践指南》虚拟线程是Java中的一种轻量级线程,由JVM管理,特别适合于I/O密集型任务,：本文主要介绍JDK21对虚拟线程的几种用法,文中通过代码介绍的非常详细,... 目录一、参考官方文档二、什么是虚拟线程三、几种用法1、Thread.ofVirtual().start(
阅读更多...
Java HashMap的底层实现原理深度解析

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述：HashMap的宏观结构二、核心数据结构解析1. 数组（桶数组）2. 链表节点（Node
阅读更多...
Java AOP面向切面编程的概念和实现方式

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点（如日志、事务）与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么？二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关
阅读更多...
详解SpringBoot+Ehcache使用示例

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储：配置灵活性：编码示例引入依赖：配置ehcache.XML文件：配置
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2