news 2026/8/9 17:51:56

拦截器注册InterceptorRegistry 实现讲解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
拦截器注册InterceptorRegistry 实现讲解
1.核心概念

InterceptorRegistrySpring MVC提供的拦截器注册器,用于配置拦截器的拦截规则。

2.主要方法
addInterceptor(): 添加拦截器 addPathPatterns(): 指定要拦截的路径 excludePathPatterns(): 指定要排除的路径 路径匹配规则 /api/**: 匹配 /api/ 下的所有路径(包括多级子路径) /api/*: 只匹配 /api/ 下的一级路径 /api/user/login: 精确匹配某个具体路径
3.完整实现代码
​ package com.itheima.miniblog.core.interceptor; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.InterceptorRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; // 配置拦截器 @Configuration // 添加这个注解,让 Spring 识别这是一个配置类 public class WebMvcConfig implements WebMvcConfigurer { @Autowired private AuthInterceptor authInterceptor; @Override public void addInterceptors(InterceptorRegistry registry) { // 注册认证拦截器 registry.addInterceptor(authInterceptor) // 添加拦截器 .addPathPatterns("/api/**") // 拦截所有 /api/** 路径 .excludePathPatterns( // 排除以下路径(不需要登录验证) "/api/user/login", // 登录接口 "/api/user/register" // 注册接口 ); } }
4.详细解释

1. @Configuration 注解

@Configuration

告诉 Spring 这是一个配置类

Spring 会自动扫描并加载这个配置

如果没有这个注解,配置可能不会生效

2. registry.addInterceptor(authInterceptor)

registry.addInterceptor(authInterceptor)

将我们自定义的 AuthInterceptor 注册到 Spring MVC

authInterceptor 通过 @Autowired 自动注入

3. addPathPatterns("/api/")**

.addPathPatterns("/api/**")

指定拦截器要拦截的路径

** 表示匹配任意多级路径

例如会拦截:

/api/user/info

/api/article/list

/api/comment/add

4. excludePathPatterns(...)

.excludePathPatterns(

"/api/user/login",

"/api/user/register"

)

排除不需要登录验证的接口

即使这些路径匹配 /api/**,也不会被拦截

常见的排除路径:

登录接口

注册接口

验证码接口

公开的文章列表等

5.执行流程示例

场景 1:访问登录接口

请求: POST /api/user/login ↓ 匹配 /api/** ✓ ↓ 在排除列表中 ✓ ↓ 不执行拦截器,直接放行 ✓ 场景 2:访问用户信息接口 请求: GET /api/user/info ↓ 匹配 /api/** ✓ ↓ 不在排除列表中 ✓ ↓ 执行 AuthInterceptor.preHandle() ✓ ↓ 检查 Token,验证登录状态

扩展配置示例

如果你需要更复杂的配置,可以这样写:

@Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(authInterceptor) .addPathPatterns("/api/**") .excludePathPatterns( "/api/user/login", // 登录 "/api/user/register", // 注册 "/api/user/captcha", // 验证码 "/api/article/list", // 公开的文章列表 "/api/article/detail/**" // 公开的文章详情 ) .order(1); // 设置拦截器执行顺序(数字越小越先执行) }
6.常见问题

Q1: 为什么配置了拦截器但不生效?

检查是否添加了 @Configuration 注解 检查 AuthInterceptor 是否添加了 @Component 注解 检查路径是否正确匹配

Q2: 如何拦截多个不同的路径?

.addPathPatterns("/api/**", "/admin/**", "/user/**")

Q3: 如何排除某个目录下的所有接口?

.excludePathPatterns("/api/public/**") // 排除所有 /api/public/ 下的接口

这样配置后,所有访问 /api/** 的请求都会经过AuthInterceptor的验证,除了登录和注册接口可以直接访问。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/9 3:15:17

云南昆明/南宁/海南海口品牌快闪店设计搭建公司哪家好?

在消费升级与商业创新双重驱动下,国内城市核心商圈正涌现出一批以短期空间运营为特色的新型商业实践。这类空间通过主题化场景构建、限时性体验设计以及社交化互动机制,形成了独特的商业空间运营模式。其凭借差异化的内容呈现与精准的受众定位&#xff0…

作者头像 李华
网站建设 2026/8/9 9:51:57

外设与接口:基于内核 gpio-keys 子系统的按键处理

1 基本原理 在 Linux 中,gpio-keys 是一个平台驱动(Platform Driver),它充当了物理 GPIO 硬件与 Linux 标准输入子系统(Input Subsystem)之间的“翻译官”。 整个处理流程自下而上分为四层: 硬件…

作者头像 李华
网站建设 2026/8/9 13:34:26

测试的“元认知”:智能体如何评估自身可靠性?

在软件测试领域,自动化与智能化正以前所未有的速度重塑工作流程。随着人工智能代理(智能体)广泛应用于测试用例生成、缺陷预测和持续集成,一个关键问题浮出水面:这些智能体如何像人类测试专家一样,对自身行…

作者头像 李华
网站建设 2026/8/9 12:14:40

本凡码农引领杭州小程序开发解决方案赋能企业创新与发展

本凡码农的杭州小程序开发解决方案为企业提供了一种高效的数字化转型工具。我们的目标是帮助品牌快速适应市场变化,提升用户体验。通过定制化的小程序,企业能够实现从线上到线下的无缝连接,简化业务流程,从而更好地满足用户需求。…

作者头像 李华
网站建设 2026/8/8 6:42:41

Windows11系统文件wer.dll丢失或损坏问题 下载修复

在使用电脑系统时经常会出现丢失找不到某些文件的情况,由于很多常用软件都是采用 Microsoft Visual Studio 编写的,所以这类软件的运行需要依赖微软Visual C运行库,比如像 QQ、迅雷、Adobe 软件等等,如果没有安装VC运行库或者安装…

作者头像 李华