拦截器失效怎么办

“拦截器失效”这个问题比较宽泛，通常涉及前端（如 Axios、前端路由）、后端（如 Spring、Express/Koa）或网络代理等场景。由于您没有指定具体技术栈，我为您梳理了排查思路和常见场景的解决方案。

请先确认您是在哪种场景下遇到问题的：

一、通用排查思路（必看）

无论哪种拦截器，失效通常遵循以下三个原因：

1. 没有注册/挂载：写了拦截器但没把它加到实例或框架中。
2. 执行顺序/匹配规则问题：请求没命中拦截器，或被优先级更高的配置覆盖了。
3. 代码逻辑错误：拦截器内部报错，或条件判断导致直接放行。

二、常见场景及解决方案

场景 1：Axios 拦截器失效（前端最常见）

现象：请求没有经过 request 拦截器，或响应没有经过 response 拦截器。

排查与解决：

1. 检查实例是否统一：
   • 如果你封装了 Axios 实例（如 request.js），确保全项目都引入的是这个实例，而不是原生 axios。
   • ❌ 错误：import axios from 'axios'; axios.get(...)
   • ✅ 正确：import request from './utils/request'; request.get(...)
2. 检查挂载方式：

   // 正确示例
   const service = axios.create();
   service.interceptors.request.use(config => {
       config.headers['Token'] = 'xxx';
       return config; // 必须返回 config
   });
   

3. 返回 config：在 request 拦截器中，如果漏了 return config，请求会卡住或直接失败。

场景 2：Spring Boot 拦截器 (Interceptor) 失效

现象：访问 API 时，拦截器的 preHandle 没有执行。

排查与解决：

1. 是否注册了拦截器？ Java 的拦截器写完必须注册。检查是否有 @Configuration 类实现了 WebMvcConfigurer。

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

2. 路径匹配问题：
   • addPathPatterns 是否正确？如果配了 /api/*，访问 /api/user/list 可能拦截不到（需注意通配符）。
   • 建议使用 /** 测试，再逐步缩小范围。
3. 拦截器 Bean 没被 Spring 管理：
   • 如果 MyInterceptor 没有加 @Component，或者注册时没有 @Bean 注入，可能导致 @Autowired 注入的 Service 为 null，从而报错失效。
4. Spring Boot 版本问题：
   • 如果是 Spring Boot 2.5+ 或 3.x，确保没有使用过时的 API。

场景 3：Spring Security 过滤器 (Filter) 失效

现象：JWT 或登录校验没生效。

排查与解决：

1. Order 顺序问题：如果同时使用了 Spring Security 和自定义 Filter，Security 的过滤器链可能优先级更高。
2. 配置类：确保过滤器已通过 FilterRegistrationBean 注册，或在配置类中定义。

场景 4：Vue/Router 路由守卫失效

现象：路由跳转前没有弹出登录框或没有校验权限。

排查与解决：

1. 检查挂载位置：

   // main.js 或 router/index.js
   router.beforeEach((to, from, next) => {
       // 逻辑...
       next(); // 必须调用 next
   });
   

2. next 函数：如果没有调用 next()，路由会卡死；如果逻辑分支中漏掉 next()，也会表现为“失效”。

场景 5：Express/Koa 中间件失效

现象：中间件没有处理请求。

排查与解决：

1. next() 调用：
   • Express：必须调用 next() 才能流向下一个中间件。
   • Koa：必须调用 await next()。
2. 注册顺序：
   • 中间件必须在路由之前注册。

   app.use(loggerMiddleware); // 先
   app.use(router.routes());  // 后
   

三、快速自检清单

请对照检查：

• [ ] 拦截器/中间件是否被 export 并正确导入？
• [ ] 是否调用了注册方法（如 use, addInterceptors）？
• [ ] 拦截器内部是否有 return 或 next() 的遗漏？
• [ ] 拦截器的路径/URL 匹配规则是否覆盖了当前请求？
• [ ] 控制台是否有报错信息（很多时候是拦截器内部报错导致后续不执行）？

四、如果您需要更具体的帮助

请补充以下信息，我可以直接定位代码问题：

1. 技术栈：例如 Vue3 + Axios、Spring Boot 3.x、React + Redux 等。
2. 代码片段：请把拦截器的定义代码和注册代码贴出来。
3. 具体表现：是完全不进拦截器，还是偶尔失效？