当前位置：首页 > news >正文

spring中的Interceptor使用说明

news 来源：原创 2025/6/6 2:41:41

一、Interceptor 的核心概念

Interceptor（拦截器）是 Spring MVC 提供的一种机制，用于在请求处理的不同阶段插入自定义逻辑。其核心作用包括：
• 预处理：在控制器方法执行前进行权限校验、日志记录等。

• 后处理：在控制器方法执行后修改响应数据或记录结果。

• 资源清理：在整个请求完成后释放资源或处理异常。

与 Filter 的区别：

特性	Interceptor（拦截器）	Filter（过滤器）
作用范围	针对 Spring MVC 的控制器层	作用于 Servlet 容器层面
依赖框架	Spring MVC 管理	Servlet 原生规范
数据访问	可操作 `ModelAndView`	仅能操作 `HttpServletRequest/Response`。

在这里插入图片描述

二、Interceptor 的创建与配置

实现拦截器类
继承 HandlerInterceptor 接口，重写以下方法：

public class AuthInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {// 请求前处理（如权限校验）return true; // 返回 false 中断请求}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {// 控制器执行后、视图渲染前处理（如修改 Model 数据）}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {// 请求完成后处理（如资源清理）}
}

注册拦截器
通过 WebMvcConfigurer 的 addInterceptors 方法配置：

@Configuration
public class WebConfig implements WebMvcConfigurer {@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new AuthInterceptor()).addPathPatterns("/api/**")     // 拦截路径.excludePathPatterns("/login"); // 排除路径}
}

• 路径匹配规则：支持 Ant 风格（如 /user/* 匹配单层路径，/admin/** 匹配多级路径）。

• 多拦截器顺序：通过 Order 注解或实现 Ordered 接口控制优先级，值越小优先级越高。

三、拦截器的执行顺序

假设注册了 Interceptor1 和 Interceptor2：

preHandle 方法：按注册顺序执行（Interceptor1 → Interceptor2）。
postHandle 方法：按注册逆序执行（Interceptor2 → Interceptor1）。
afterCompletion 方法：按注册逆序执行（Interceptor2 → Interceptor1）。

中断场景：若某一拦截器的 preHandle 返回 false，后续拦截器和控制器均不执行，但已通过 preHandle 的拦截器的 afterCompletion 仍会执行。

四、典型应用场景

权限校验
在 preHandle 中检查用户登录状态或角色权限，拒绝非法请求。

if (request.getSession().getAttribute("user") == null) {response.sendRedirect("/login");return false;
}

日志记录
记录请求路径、参数、耗时等信息：

long startTime = System.currentTimeMillis();
request.setAttribute("startTime", startTime);
// 在 afterCompletion 中计算耗时

性能监控
统计接口响应时间，优化慢请求。
数据预处理
在 postHandle 中统一添加响应头或加密敏感数据。

五、注意事项与最佳实践

性能优化
• 避免在拦截器中执行耗时操作（如远程调用）。

• 合理设置拦截路径，减少不必要的拦截。
常见问题排查
• 拦截器未生效：检查路径匹配规则、是否注册到 Spring 容器。

• 顺序混乱：通过 @Order 明确优先级。
与 AOP 结合
拦截器适用于请求生命周期中的横切逻辑，而 AOP 更适用于方法级别的切面（如事务管理）。

六、完整示例

日志拦截器

public class LogInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {System.out.println("请求开始: " + request.getRequestURI());return true;}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {System.out.println("请求完成: " + request.getRequestURI());}
}

配置类

@Configuration
public class WebConfig implements WebMvcConfigurer {@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new LogInterceptor()).addPathPatterns("/**");registry.addInterceptor(new AuthInterceptor()).addPathPatterns("/admin/**").order(1); // 高优先级}
}