springboot 拦截器不生效

### Spring Boot 拦截器不生效的原因及解决方案 #### 原因分析 Spring Boot 拦截器不生效的主要原因可能涉及以下几个方面： 1. **包扫描范围问题** 如果 `WebConfig` 配置类不在 Spring Boot 启动类所在的包及其子包范围内，则可能导致拦截器配置未被加载。这是因为 Spring Boot 默认只会扫描启动类所在包及其子包下的组件[^1]。 2. **Bean 实例化顺序问题** 当拦截器逻辑依赖于其他 Bean（如 RedisTemplate），而这些 Bean 尚未完成初始化时，可能会导致注入失败或拦截器行为异常。这是由于拦截器的执行优先级高于大多数 Bean 的实例化过程[^2]。 3. **配置错误** 如果在定义拦截器时未正确注册路径模式（Path Pattern）或未将拦截器添加到全局拦截器列表中，也可能导致拦截器无法正常工作[^4]。 --- #### 解决方案 以下是针对上述问题的具体解决措施： 1. **调整包结构** 确保 `WebConfig` 或自定义拦截器所在的包位于 Spring Boot 应用程序启动类所在的包或其子包下。如果需要保留当前包结构，可以通过显式设置 `@ComponentScan` 注解来扩展扫描范围。例如： ```java @SpringBootApplication @ComponentScan(basePackages = {"com.example", "itheima"}) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 2. **延迟 Bean 初始化** 对于需要依赖其他 Bean 的场景，可以考虑通过懒加载 (`@Lazy`) 或者使用 `ApplicationContext` 动态获取所需 Bean 来规避初始化顺序冲突。例如： ```java @Component public class CustomInterceptor implements HandlerInterceptor { private final RedisTemplate<String, Object> redisTemplate; public CustomInterceptor(RedisTemplate<String, Object> redisTemplate) { this.redisTemplate = redisTemplate; } @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String value = (String) redisTemplate.opsForValue().get("key"); System.out.println(value); return true; } } ``` 3. **检查拦截器注册** 确认拦截器已正确注册至 `WebMvcConfigurer` 中，并设置了合适的匹配规则。例如： ```java @Configuration public class WebConfig implements WebMvcConfigurer { @Autowired private CustomInterceptor customInterceptor; @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(customInterceptor).addPathPatterns("/api/**").excludePathPatterns("/api/exclude"); } } ``` 4. **排查日志信息** 开启调试日志以定位具体问题。可以在 `application.properties` 文件中增加如下配置： ```properties logging.level.org.springframework.web=DEBUG ``` --- ### 总结 Spring Boot 拦截器不生效通常由包扫描范围不足、Bean 初始化顺序不当以及配置遗漏等原因引起。通过合理调整包结构、优化 Bean 加载方式并仔细校验拦截器注册逻辑，可有效解决问题[^3]。 ---