springboot拦截器白名单不生效

### 解析 Spring Boot 拦截器白名单不生效解决方案

#### 1. 配置路径模式匹配规则
确保 `excludePathPatterns` 属性配置无误。此属性用于定义不需要被拦截的URL路径列表，支持Ant风格通配符语法[^3]。

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(new MyCustomInterceptor())
            .addPathPatterns("/**") // 所有请求都被拦截
            .excludePathPatterns("/login", "/register", "/static/**"); // 白名单路径
}

#### 2. 启动类位置校验
确认启动类位于合适的位置以便能够扫描到自定义配置类。当Web配置类（如实现了`WebMvcConfigurer`接口并重写了`addInterceptors()`方法的类）不在主应用程序类所在的包或其子包内时，可能会导致组件未被正确加载[^2]。

#### 3. 资源映射处理
对于静态资源文件夹下的资源访问应予以豁免，通常建议将所有前端所需的静态资源统一放置于特定目录下，并通过单一表达式来排除这些资源的拦截需求。

#### 4. 日志调试辅助诊断
启用日志记录可以帮助追踪实际发生的过滤过程，便于发现潜在问题所在。可以在application.properties中增加如下配置项开启debug级别日志输出：

logging.level.org.springframework.web=DEBUG

这有助于观察每次HTTP请求经过哪些处理器以及它们是如何工作的。

#### 5. 测试验证机制健全性
构建单元测试案例模拟不同场景下的请求行为，特别是针对那些应该绕过拦截逻辑的情况做重点检验。利用MockMvc工具可以方便地完成这项工作。