java拦截器怎么生效

在 Java（通常指 Spring / Spring Boot） 中，拦截器（Interceptor）要“生效”，一般分两步：写拦截器类 + 注册到 Spring 容器。下面用最常见的方式说明。

一、Spring MVC 拦截器（最常用）

1️⃣ 编写拦截器类

实现 HandlerInterceptor 接口：

@Component
public class LoginInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response,
                             Object handler) throws Exception {
        // 在 Controller 之前执行
        System.out.println("拦截器生效了");
        return true; // true 放行，false 拦截
    }

    @Override
    public void postHandle(HttpServletRequest request,
                           HttpServletResponse response,
                           Object handler,
                           ModelAndView modelAndView) throws Exception {
        // Controller 执行后
    }

    @Override
    public void afterCompletion(HttpServletRequest request,
                                HttpServletResponse response,
                                Object handler,
                                Exception ex) throws Exception {
        // 视图渲染后
    }
}

2️⃣ 注册拦截器（关键步骤）

实现 WebMvcConfigurer：

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Autowired
    private LoginInterceptor loginInterceptor;

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

✅ 到这一步，拦截器就生效了

二、拦截器不生效的常见原因

❌ 1. 没注册

只写 Interceptor 不注册 = 不生效

❌ 2. 路径写错

.addPathPatterns("/api/**")

但请求是 /user/list

❌ 3. 被 Spring Security 拦截

Security 优先级高于 Interceptor

❌ 4. 静态资源没放行

.excludePathPatterns("/css/**", "/js/**")

❌ 5. 用了 @Component 但没扫描到

检查包路径是否在启动类扫描范围内

三、拦截器 vs 过滤器（容易混）

四、简单验证是否生效

System.out.println("拦截器执行");

或打断点看是否进入 preHandle

如果你用的是：

• Spring Boot
• Spring Security
• MyBatis / RPC / Feign
• 非 Web 的 AOP 拦截

可以告诉我具体场景，我可以给你更精确的配置方式。