如何自定义拦截器

“拦截器”这个概念在不同技术栈里含义略有不同，最常见的是 Spring 拦截器、Vue/React 请求拦截器、Axios 拦截器 等。下面我按最常见的几种场景分别说明，你可以直接跳到你用到的那一块。

一、Spring Boot 自定义拦截器（最常见）

1️⃣ 定义拦截器（实现 HandlerInterceptor）

import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;

@Component
public class MyInterceptor implements HandlerInterceptor {

    // 控制器方法执行前
    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response,
                             Object handler) throws Exception {
        System.out.println("请求拦截：" + request.getRequestURI());
        return true; // true 放行，false 拦截
    }

    // 控制器方法执行后
    @Override
    public void postHandle(HttpServletRequest request,
                           HttpServletResponse response,
                           Object handler,
                           org.springframework.web.servlet.ModelAndView modelAndView) {
        System.out.println("请求处理完成");
    }

    // 整个请求完成后
    @Override
    public void afterCompletion(HttpServletRequest request,
                                HttpServletResponse response,
                                Object handler,
                                Exception ex) {
        System.out.println("请求结束");
    }
}

2️⃣ 注册拦截器（实现 WebMvcConfigurer）

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 MyInterceptor myInterceptor;

    public WebConfig(MyInterceptor myInterceptor) {
        this.myInterceptor = myInterceptor;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myInterceptor)
                .addPathPatterns("/api/**")   // 拦截路径
                .excludePathPatterns("/api/login"); // 排除路径
    }
}

✅ 适合做：

• 登录校验
• 权限控制
• 接口耗时统计
• 日志记录

二、Axios 自定义拦截器（前端）

1️⃣ 请求拦截器

axios.interceptors.request.use(
  config => {
    const token = localStorage.getItem('token');
    if (token) {
      config.headers.Authorization = `Bearer ${token}`;
    }
    return config;
  },
  error => Promise.reject(error)
);

2️⃣ 响应拦截器

axios.interceptors.response.use(
  response => response,
  error => {
    if (error.response.status === 401) {
      console.log('未登录或 token 失效');
    }
    return Promise.reject(error);
  }
);

✅ 适合做：

• token 自动注入
• 接口错误统一处理
• loading 状态管理

三、Vue / React 项目中的拦截思想

在 Vue/React 中，拦截器通常不是框架本身提供，而是：

• Axios 拦截器
• Router 守卫（路由拦截）

Vue Router 路由拦截示例

router.beforeEach((to, from, next) => {
  const token = localStorage.getItem('token');
  if (to.meta.requiresAuth && !token) {
    next('/login');
  } else {
    next();
  }
});

四、对比总结

如果你能告诉我：

• ✅ 用的是什么技术（Spring / Vue / React / Axios / Gateway）
• ✅ 想拦截什么（登录、权限、日志、参数校验）

我可以直接给你定制一份完整可用的拦截器代码。