Spring Boot 拦截器(Interceptor)详解:用法与实现原理

拦截器(HandlerInterceptor) 拦截器是相对于Spring中来说的,它和过滤器不一样,过滤器的范围更广一些是相对于Tomcat容器来说的。拦截器可以对用户进行拦截过滤处理。请求进入Controller之前,通过拦截器执行代码逻辑Controller执行之后(只是Controller执行完毕,视图还没有开始渲染),通过拦截器执行代码逻辑Controller完全执行完毕(整个请求全部结束),通过拦截器执行代码逻辑。 阅读详情
AI摘要

本文详细介绍了 Spring Boot 拦截器,它可在请求处理前后执行特定逻辑。阐述了拦截器的核心概念、应用场景、实现步骤和进阶用法,对比了拦截器与过滤器,还给出注意事项与最佳实践,指出其具有非侵入式增强、细粒度控制等优势。

在 Spring Boot 中,拦截器(Interceptor)是一种强大的组件,用于在请求处理的前后执行特定逻辑,例如日志记录、权限校验、性能监控等。它与 AOP 类似,但更专注于 Web 请求的拦截,且属于 Servlet 层的处理机制。

一、拦截器的核心概念与应用场景

核心概念:

  • HandlerInterceptor:Spring 提供的拦截器接口,包含三个核心方法:
    • preHandle():请求处理前执行(控制器方法调用前)。
    • postHandle():请求处理后执行(控制器方法调用后,但视图渲染前)。
    • afterCompletion():整个请求完成后执行(视图渲染完成后)。
  • 执行顺序:多个拦截器按注册顺序依次执行 preHandle(),逆序执行 postHandle() 和 afterCompletion()。

典型应用场景:

  • 日志记录:记录请求信息、执行时间。
  • 权限校验:验证用户权限,拒绝未授权请求。
  • 性能监控:统计接口响应时间。
  • 参数预处理:统一处理请求参数(如编码转换)。
  • 请求限流:限制请求频率,防止恶意攻击。
二、拦截器的实现步骤
1. 创建拦截器类,实现 HandlerInterceptor 接口
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;

@Component
public class LogInterceptor implements HandlerInterceptor {

    // 请求处理前执行
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        System.out.println("PreHandle: 请求路径=" + request.getRequestURI());
        // 返回 true 表示继续执行后续流程,返回 false 则中断请求
        return true;
    }

    // 请求处理后执行(视图渲染前)
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, 
                           ModelAndView modelAndView) {
        System.out.println("PostHandle: 请求处理完成");
    }

    // 整个请求完成后执行(视图渲染后)
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
                                Object handler, Exception ex) {
        System.out.println("AfterCompletion: 请求流程完全结束");
    }
}
2. 注册拦截器,配置拦截路径
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    private final LogInterceptor logInterceptor;

    public WebConfig(LogInterceptor logInterceptor) {
        this.logInterceptor = logInterceptor;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注册日志拦截器,拦截所有请求
        registry.addInterceptor(logInterceptor)
                .addPathPatterns("/**")          // 拦截所有路径
                .excludePathPatterns("/static/**", "/error"); // 排除静态资源和错误路径
    }
}
三、拦截器的进阶用法
1. 权限校验拦截器
@Component
public class AuthInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 从请求头或 Session 中获取用户信息
        String token = request.getHeader("Authorization");
        
        // 校验 token 有效性(示例逻辑,实际需结合 JWT 或 Session)
        if (token == null || !isValidToken(token)) {
            response.setStatus(HttpServletResponse.SC_UNAUTHORIZED);
            return false; // 拒绝请求
        }
        
        // 将用户信息存入请求属性,供后续流程使用
        request.setAttribute("user", parseUserFromToken(token));
        return true;
    }
    
    private boolean isValidToken(String token) {
        // 实际项目中需验证 token 签名、过期时间等
        return token.startsWith("Bearer ");
    }
    
    private User parseUserFromToken(String token) {
        // 解析 token 中的用户信息
        return new User("testUser");
    }
}

注册配置:

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(authInterceptor)
            .addPathPatterns("/api/**")      // 拦截 API 路径
            .excludePathPatterns("/api/login", "/api/register"); // 排除登录注册接口
}
2. 性能监控拦截器
@Component
public class PerformanceInterceptor implements HandlerInterceptor {

    private final ThreadLocal<Long> startTime = new ThreadLocal<>();

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        startTime.set(System.currentTimeMillis());
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
                                Object handler, Exception ex) {
        long elapsedTime = System.currentTimeMillis() - startTime.get();
        startTime.remove(); // 防止内存泄漏
        
        // 记录耗时超过 500ms 的请求
        if (elapsedTime > 500) {
            System.out.println("Slow request: " + request.getRequestURI() + 
                              ", time=" + elapsedTime + "ms");
        }
    }
}
3. 多拦截器执行顺序
@Override
public void addInterceptors(InterceptorRegistry registry) {
    // 先注册的拦截器 preHandle 先执行,postHandle 后执行
    registry.addInterceptor(new FirstInterceptor()).addPathPatterns("/**");
    registry.addInterceptor(new SecondInterceptor()).addPathPatterns("/**");
}

// 执行顺序示例:
// FirstInterceptor.preHandle() → SecondInterceptor.preHandle() 
// → Controller → SecondInterceptor.postHandle() → FirstInterceptor.postHandle()
// → SecondInterceptor.afterCompletion() → FirstInterceptor.afterCompletion()
四、拦截器与过滤器(Filter)的对比
特性拦截器(Interceptor)过滤器(Filter)
所属框架Spring MVCServlet 规范
执行时机在 DispatcherServlet 之后,Controller 之前 / 之后在 Servlet 容器接收请求后立即执行
使用场景权限校验、日志记录、性能监控字符编码处理、跨域设置、请求过滤
访问 Spring Bean可以(实现 Spring 接口)不可以(Servlet 规范组件)
拦截范围仅拦截 Spring 管理的请求(如 Controller)拦截所有请求(包括静态资源)
接口类型HandlerInterceptorjavax.servlet.Filter
五、注意事项与最佳实践
1. 线程安全问题
  • 拦截器是单例(Singleton),避免在拦截器中使用实例变量存储请求相关数据。
  • 使用 ThreadLocal 存储线程私有数据(如上文的 startTime),并在 afterCompletion() 中清理。
2. 异常处理
  • 在 preHandle() 中抛出异常会中断请求流程,需通过 response 设置错误响应。
  • 建议统一异常处理,结合 Spring 的 @ControllerAdvice 和 @ExceptionHandler。
3. 性能优化
  • 避免在拦截器中执行耗时操作,尤其是 preHandle(),可能阻塞请求处理。
  • 对静态资源(如 CSS、JS)配置 excludePathPatterns,减少不必要的拦截。
4. 路径匹配规则
  • /**:匹配所有路径(包括子路径)。
  • /*:匹配一级路径(如 /user,但不匹配 /user/1)。
  • *.html:匹配扩展名(如 /index.html)。

总结

Spring Boot 拦截器是处理 Web 请求的强大工具,通过实现 HandlerInterceptor 接口并注册到 WebMvcConfigurer,可以在请求处理的不同阶段插入自定义逻辑。其核心优势在于:

  • 非侵入式增强:不修改原有代码即可添加功能。
  • 细粒度控制:通过路径匹配精准拦截特定请求。
  • 多拦截器协作:支持按顺序执行多个拦截器,实现复杂流程。
SpringBoot(十五)拦截器 阅读详情

相关推荐

Spring Boot拦截器(Interceptor)详解

在拦截器当中,我们通常也是做一些通用性的操作,比如:我们可以通过拦截器来拦截前端发起的请求,将登录校验的逻辑全部编写在拦截器当中。方法,这个方法执行完成后需要返回一个布尔类型的值,如果返回true,就表示放行本次操作,才会继续访问controller中的方法;以上就是拦截器的执行流程。,表示拦截所有资源,而在配置拦截器时,不仅可以指定要拦截哪些资源,还可以指定不拦截哪些资源,只需要调用。首先我们先来看拦截器的拦截路径的配置,在注册配置拦截器的时候,我们要指定拦截器的拦截路径,通过。

Delu3376451753的博客 2583

Springboot——拦截器

假设controller层抛了异常,在这里是可以拿到异常对象的,但是我们有异常处理机制,所以这里就没有那么大的需求了。封装了SpringMVC进行页面跳转的相关数据,但是我们现在都是反JSON,一般不会这么搞了。是一种动态拦截方法调用的机制,在SpringMVC中动态拦截控制器方法的执行。通过这个ex可以拿到原始的程序执行过程中出现的异常的。那当我们配置了两个拦截器以后,会有一个执行顺序。Object handler 是什么参数。request:请求对象。response:响应对象。

weixin_51351637的博客 4万+

【登录校验】0-1,初步认识会话技术,JWT令牌,过滤器Filter与拦截器Interceptor

过滤器(Filter)是Java Web技术中用于拦截HTTP请求与响应的组件,基于javax.servlet.Filter接口实现。请求预处理:在请求到达Servlet前拦截,进行权限验证、参数校验、日志记录等操作。响应后处理:在响应返回客户端前拦截,实现数据压缩、内容加密等功能。动态控制请求流程:通过FilterChain决定是否放行请求或直接返回响应。

2302_79600390的博客 1223

全面了解SpringBoot拦截器

拦截器(Interceptor)是一种特殊的组件,它可以在请求处理的过程中对请求和响应进行拦截和处理。拦截器可以在请求到达目标处理器之前、处理器处理请求之后以及视图渲染之前执行特定的操作。拦截器的主要目的是在不修改原有代码的情况下,实现对请求和响应的统一处理。本文详细介绍了SpringBoot中的拦截器,包括拦截器的概念、作用、实现方式、执行顺序、生命周期以及高级应用。我们还探讨了拦截器的性能优化策略和常见问题。希望本文能帮助您更好地理解和使用SpringBoot中的拦截器。

万猫学社 2万+

springboot——登录认证(包括jwt技术、拦截器过滤器)

在实际应用中,这个秘钥应该是一个随机生成的强密钥,并且保密,只有服务器知道。在随后的请求中,前端需要将这个令牌携带在请求中发送给后端,以便于进行身份验证和授权。请注意,存储在浏览器中的令牌可能会受到跨站脚本攻击(XSS)的威胁,因此,确保前端应用的安全性是非常重要的。此外,使用HTTPS协议可以保护令牌在传输过程中的安全。2. 拦截范围不同:过滤器Filter会拦截所有的资源,而Interceptor只会拦截Spring环境中的资源。作用:拦截请求,在指定的方法调用前后,根据业务需求执行预先设定的代码。

2301_80412275的博客 1367

别再为OpenBCI_GUI安装发愁了!保姆级教程带你从Processing配置到成功运行(附常见错误解决)

本文提供了一份详细的OpenBCI_GUI安装教程,涵盖从Processing配置到成功运行的全过程,特别针对常见错误提供了解决方案。通过环境搭建、软件依赖安装、源码处理及首次运行实战,帮助用户高效完成数据可视化工具的部署与使用。

weixin_28366475的博客 272

Spring Boot Interceptor(拦截器使用及原理)

Spring 拦截器的使用详解以及源码级原理解释,看完直接理解并且上手。

关关的博客 2296

SuperMap iObjects Java组件开发——环境部署(IntelliJ IDEA)

SuperMap iObjects Java 是面向GIS应用系统开发者的组件式GIS开发平台,具有强大的地理数据管理、编辑、显示、分析等功能,并且其具有极强的易用性和丰富的帮助资源,适宜快速开发大型GIS应用系统。本文将介绍如何在IntelliJ IDEA集成开发环境中进行SuperMap iObjects Java组件的环境部署。

nan620403的博客 1083

Spring Boot2 —— 拦截器Interceptor原理以及源码详解

拦截器 文章目录拦截器一、HandlerInceptor二、配置拦截器三、拦截器原理 一、HandlerInceptor /** * 登录检查 * 1、配置好拦截器要拦截哪些请求 * 2、把这些配置放在容器中 */ @Slf4j public class LoginInterceptor implements HandlerInterceptor { /** * 目标方法执行之前 * @param request * @param response

qq_35843514的博客 1234

论文阅读笔记:Extended Vision Transformer (ExViT) for Land Use and Land Cover Classification

注意力机制驱动的深度模型最近取得了成功,如最具代表性的视觉转换器(ViT),吸引了一波高级研究来探索它们对更广泛领域的适应。然而,遥感(RS)领域中基于Transformer的方法更关注单模态数据,这可能会在充分利用不断增长的多模态地球观测数据时失去可扩展性。为此,我们提出了一种新的多模式深度学习框架,通过在最小修改的情况下扩展传统的ViT,针对土地利用和土地覆盖(LULC)分类任务。

嗑研狗的日常 947

FA 新增资产API Demo

DECLARE l_trans_rec fa_api_types.trans_rec_type; l_dist_trans_rec fa_api_types.trans_rec_type; l_asset_hdr_rec fa_api_types.asset_hdr_rec_type; l_asset_desc_rec fa_a

chosen1brain的专栏 2144

【Spring Boot】Interceptor的原理、配置、顺序控制及与Filter的关键区别

Spring Boot 中,拦截器通常用于在请求处理前后执行一些逻辑,这点与Servlet容器提供的过滤器有点类似。平常我们开发Jave Web应用的时候,经常能碰到要对请求访问进行通用逻辑处理的场景,比方说记录访问日志、确认访问权限等。你是否曾经纠结于是选过滤器还是拦截器来实现逻辑代码的编写,本篇文章先重点介绍Spring中的interceptor拦截器, 然后就过滤器和拦截器这两个常见但易混淆的请求拦截工具,讨论两者相似且不同之处。

Arabys的博客 1359

新手避坑指南:在MacBook上为PyTorch正确配置MPS环境,跑通第一个YOLOv8训练

本文详细指导新手如何在MacBook上为PyTorch正确配置MPS环境,并成功运行YOLOv8训练。从环境准备、PyTorch安装到YOLOv8配置和性能调优,提供全面的避坑指南和实用技巧,帮助开发者充分利用Mac的GPU加速能力。

weixin_29100399的博客 231

Filter过滤器与Interceptor拦截器

Springboot中用来统一拦截请求,防止不合法的资源访问。

Ydt____的博客 867

计算机组成原理(第三版)唐朔飞-第六章计算机的运算方法-课后习题(1-16)

计算机组成原理(第三版)唐朔飞-第六章计算机的运算方法-课后习题(1-16)

weixin_45735391的博客 8万+

Qwen大模型参数解析

Qwen系列模型的参数主要分为(决定模型结构)和(控制生成行为)两类。由于该系列已迭代多个版本,参数设计也在不断演进,我会结合最新版本为你进行分层梳理。

yeyiboy的博客 173

Java里过滤器(filter)与拦截器(Interceptor)的区别和使用

filter是实现javax.servlet.Filter,该接口由servlet规范定义,使用过滤器(filter)需要依赖于servlet容器,如Tomcat容器。interceptor(拦截器)是在请求到达servlet之后在进入action(controller)之前进行预处理,在action(controller)处理完返回视图前再处理,待action(controller)返回视图后进行最终处理。filter是基于函数回调实现的,interceptor是基于Java反射机制实现的。

weixin_44341110的博客 3324

【华为OD技术面试手撕真题】134、爬楼梯 | 手撕真题+思路参考+代码解析(C & C++ & Java & Python & JS)

【华为OD技术面试手撕真题】134、爬楼梯 | 手撕真题+思路参考+代码解析(C & C++ & Java & Python & JS) 华为od机试,华为od机试真题,华为od机试E卷,华为odE卷,华为od机试真题E卷,华为OD,华为OD机试,华为OD机试真题,华为od机考,华为od机试D卷,华为od机试真题D卷,华为od手撕代码,华为od,华为od机试C卷,华为od e卷,华为2025e卷,od机试,2025E卷,华为OD机试E卷,什么是华为od,华为od介绍,全面了解华为od,2025华为od,如何

KJ.JK 2186

SpringBoot2.* 配置拦截器(Interceptor) 并 集成swagger2 3.0版本

SpringBoot 拦截器 swagger2 V3

weixin_39527642的博客 1866

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

VB摄像头监控

该VB模块可对摄像头捕获的画面进行录像等,可在创建的窗口进行控制

过滤器(filter)和拦截器(Interceptor)的区别以及使用场景

过滤器实现的是 javax.servlet.Filter 接口,而这个接口是在Servlet规范中定义的,也就是说过滤器Filter 的使用要依赖于Tomcat等容器,导致它只能在web程序中使用。拦截器 Interceptor 是在请求进入servlet后,在进入Controller之前进行预处理的,Controller 中渲染了对应的视图之后请求结束。过滤器和拦截器 底层实现方式不相同,过滤器是基于函数回调的,拦截器则是基于Java的反射机制(动态代理)实现的。过滤器 和 拦截器的触发时机不同。

itScholar001的博客 5512

计算机控制技术及应用

《计算机控制技术及应用》通过总结作者的科研成果和吸收国内外的先进理论、方法和技术,以计算机控制系统的网络化、开放化、智能化和集成化发展趋势为主线索,主要介绍计算机控制系统的基本概念和计算机控制系统的典型形式,计算机控制系统的数学描述与基本分析方法,以及数字PID控制器、最少拍控制系统、达林算法、状态变量设计法等设计方法及其各种改进算法。重点突出计算机控制系统输入输出通道接口的设计方法和典型控制系统的设计案例与实现方法等。

登录校验(令牌,过滤器,拦截器使用详解)

一文搞定,Jwt令牌,token的生产和检验,过滤器,拦截器等登录检验相关技术

qq_49474843的博客 2950

SAP B1中文培訓教材_SDK

公司内部培训资料,对开发工具 ,DIAPI, UIAPI,Add-ON有详细解说

Spring 过滤器(Filter)与拦截器(Interceptor)深度对比:原理与实战

作为一名摸爬滚打八年的 Java 开发,我敢说:**90% 的 Spring 开发者都踩过 Filter 和 Interceptor 的坑**。上周线上排查一个权限校验失效的故障,最后发现是新人把 “登录态校验” 写在了 Filter 里,却因为 Filter 无法注入 Spring Bean 导致校验逻辑形同虚设 —— 这种因为混淆两者差异引发的问题,在我八年职业生涯里见过太多次。

Minoz_wl的博客 1370

《Spring Boot 会话跟踪与拦截机制实战:从 Cookie/Session 到 JWT+Filter/Interceptor

在 Spring Boot 开发中,会话跟踪与接口拦截是保障系统安全的核心环节。本文详细解析了传统 Cookie、Session 与现代 JWT 令牌的底层原理、安全特性及选型逻辑 —— 对比三者在存储位置、集群支持、前后端分离适配性上的差异,尤其突出 JWT 无状态特性对分布式架构的优势。同时,深入讲解了 Filter(过滤器)与 Interceptor(拦截器)的实现方式、配置细节(如路径匹配、排除规则)及执行顺序,明确二者在全局通用处理与业务逻辑拦截中的职责划分。结合前后端分离场景,提供可直接复用的代

z6x6p的博客 681

拦截器与 JWT 联合使用详解

JWT 是一个开放标准(RFC 7519),用于在各方之间以 JSON 对象的形式安全地传输信息。该信息可以被验证和信任,因为它是数字签名的。JWT 结构:Header(头部):包含令牌类型(JWT)和签名算法(如 HS256、RS256)。Payload(负载):包含声明(claims),如用户 ID、用户名、过期时间等。Signature(签名):对前两部分进行签名,防止数据被篡改。典型场景:用户登录成功后,服务器生成一个 JWT 返回给客户端。客户端在后续请求的。

2503_92804185的博客 407

拦截图片代码 精易web浏览器_Spring Boot2(七):过滤器拦截器的使用

一、前言过滤器和拦截器两者都具有AOP的切面思想,关于aop切面,可以看上一篇文章。过滤器filter和拦截器interceptor都属于面向切面编程的具体实现。二、过滤器过滤器工作原理从上图可以看出,当浏览器发送请求到服务器时,先执行过滤器,然后才访问Web资源。服务器响应Response,从Web资源抵达浏览器之前,也会途径过滤器。过滤器是一个实现javax.servlet.Filter接口的...

weixin_39595487的博客 281

过滤器和拦截器的基本知识

前提提要,由于过滤器和拦截器的相关函数是没有返回值的,所以我们像前端返回数据时需要使用到中的相关函数,且需要配合阿里巴巴的插件fastjson将返回信息转为json格式,或者使用gson转为json。

weixin_73186358的博客 542
上一篇: AOP(面向切面编程)核心功能与实现方式
下一篇: ROS小车开发(一)--整体框架介绍
重生猿
博客等级 码龄4年 251粉丝 16原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址