spring boot 拦截器HandlerInterceptor 不生效的原因排查

hamish-wu2025-05-30 9:20

java 复制代码

public class UserInterceptor implements HandlerInterceptor

项目添加一个拦截器，发现未生效

1、排查拦截本身是否注入了springbean 容器

java 复制代码

@Slf4j
@Component
public class LoginInterceptor implements HandlerInterceptor {

2、排查springboot 项目扫描范围是否包含了拦截器所在目录

3、排查拦截器是否注册成功

两种注册方式相互排斥

如果同时配置一个类继承WebMvcConfigurationSupport和一个类实现

WebMvcConfigurer或者WebMvcConfigurerAdapter，就会导致只有一个生效。解决办法：将这些配置都在一个类中设置

这里全局搜索WebMvcConfigurer

和WebMvcConfigurationSuppor

发现项目中已经有了

bash 复制代码

@Configuration
public class FastJsonConfig extends WebMvcConfigurationSupport

在这里增添

bash 复制代码

@Override
  public void addInterceptors(InterceptorRegistry registry) {

    List<String> excluded=new ArrayList<>();
    excluded.add("/pc/getUserInfoByCode");
    excluded.add("pc/login");
    registry.addInterceptor(loginInterceptor)
            .addPathPatterns("/**")
            .excludePathPatterns(excluded);
    super.addInterceptors(registry);
  }

然后打断点，发现项目启动的时候拦截器注册成功，接下来可以正常拿用户登录信息了