Java Web项目中，拦截器到底应该在哪里配置生效？

在Web应用开发中，拦截器是一种强大的机制，它允许开发者在请求处理的特定阶段插入自定义逻辑，例如日志记录、权限校验、性能监控等，而无需修改核心业务代码，这种面向切面编程（AOP）的思想极大地提升了代码的模块化和可维护性，这些至关重要的拦截器应该在哪里进行配置呢？本文将详细探讨在主流的Spring Boot框架中配置拦截器的标准位置与最佳实践。

理解拦截器的工作原理

在讨论“在哪里配置”之前，我们先简单回顾一下拦截器是什么，在Spring MVC中，拦截器通常需要实现HandlerInterceptor接口,该接口定义了三个核心方法：

• preHandle(HttpServletRequest request, HttpServletResponse response, Object handler): 在控制器（Controller）方法执行之前被调用，若返回true，则继续执行后续流程；若返回false，则中断请求,通常用于权限验证或参数校验。
• postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView): 在控制器方法执行之后、视图渲染之前被调用,可以在此阶段对模型数据进行修改或统一的视图处理。
• afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex): 在整个请求处理完毕，即视图渲染结束后被调用，通常用于资源清理、记录请求总耗时等收尾工作。

了解了其生命周期后,我们才能更精确地把握配置的时机和方式。

核心配置位置：实现WebMvcConfigurer接口

在现代Spring Boot应用程序中，配置拦截器最推荐、最干净的方式是创建一个配置类并实现WebMvcConfigurer接口，这个接口提供了一系列回调方法，允许开发者自定义Spring MVC的核心组件,其中就包括拦截器。

第一步：创建自定义拦截器

你需要创建一个类来实现HandlerInterceptor接口,并编写你的拦截逻辑。

import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyCustomInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("拦截器 preHandle：请求到达控制器之前");
        // 这里可以编写权限校验逻辑
        // return false; // 会中断请求
        return true;
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("拦截器 afterCompletion：请求处理完毕，视图渲染之后");
        // 这里可以编写日志记录、资源清理等逻辑
    }
}

第二步：创建Web配置类并注册拦截器

这是问题的核心所在，你需要创建一个新的Java类，使用@Configuration注解标记它，使其成为一个Spring配置类，让这个类实现WebMvcConfigurer接口，并重写addInterceptors方法。

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 WebAppConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 在这里注册你的自定义拦截器
        registry.addInterceptor(new MyCustomInterceptor())
                .addPathPatterns("/**") // 拦截所有路径
                .excludePathPatterns("/user/login", "/static/**"); // 排除特定路径
    }
}

在addInterceptors方法中，InterceptorRegistry对象就像一个注册中心，通过调用registry.addInterceptor(),我们将第一步中创建的拦截器实例添加进来。

第三步：精细化配置拦截路径

配置拦截器不仅仅是注册它，更重要的是定义其作用范围。InterceptorRegistration对象提供了链式调用的方法来做到这一点：

• addPathPatterns(String... patterns): 指定该拦截器需要拦截的URL路径，表示拦截所有请求，"/api/**"表示只拦截以/api/开头的请求。
• excludePathPatterns(String... patterns): 指定该拦截器不需要拦截的URL路径，通常用于排除登录页面、注册接口、静态资源等。

为了更清晰地展示,以下是一些常见的配置场景：

通过这种配置方式，你可以非常灵活地控制拦截器的生效范围，确保它只在需要的地方发挥作用,避免对性能造成不必要的影响。

依赖注入的注意事项

一个常见的误区是直接在WebAppConfig中使用new MyCustomInterceptor()来创建拦截器实例，这样做虽然简单，但如果你的拦截器内部需要依赖注入其他Spring管理的Bean（例如一个UserService），那么通过new创建的对象将无法被Spring容器管理,导致依赖注入失败。

正确的做法是让Spring来管理你的拦截器，你可以在MyCustomInterceptor类上添加@Component注解，然后在WebAppConfig中将其注入进来。

// 拦截器类
@Component
public class MyCustomInterceptor implements HandlerInterceptor {
    @Autowired
    private UserService userService; // 现在可以成功注入了
    // ...
}
// 配置类
@Configuration
public class WebAppConfig implements WebMvcConfigurer {
    @Autowired
    private MyCustomInterceptor myCustomInterceptor; // 注入Spring管理的拦截器
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myCustomInterceptor) // 使用注入的实例
                .addPathPatterns("/**");
    }
}

在Spring Boot应用中，配置拦截器的标准位置是一个实现了WebMvcConfigurer接口、并由@Configuration注解标记的配置类中，通过重写addInterceptors方法，你可以将自定义的拦截器注册到InterceptorRegistry中，并利用addPathPatterns和excludePathPatterns方法精确地定义其拦截范围，遵循这种基于Java的配置方式，不仅代码整洁、易于理解，而且能完美地与Spring的依赖注入体系融合，是构建现代、可维护应用的最佳选择。

相关问答FAQs

问1：拦截器和过滤器有什么区别？我应该优先使用哪个？

答： 拦截器和过滤器是两个不同层面的概念,主要区别如下：

1. 作用范围：过滤器是Servlet规范的一部分，它作用于DispatcherServlet之前，对所有进入Web容器的请求生效，而拦截器是Spring MVC框架的组件，它作用于DispatcherServlet之后,仅在控制器方法调用前后生效。
2. 依赖：过滤器无法直接使用Spring的依赖注入，而拦截器可以,因为它处于Spring上下文中。
3. 用途：过滤器更适合处理通用的、底层的任务，如请求字符编码设置、跨域处理（CORS）、请求日志记录等，拦截器则更适合与业务逻辑相关的横切关注点，如用户权限验证、业务层日志、性能统计等。

选择建议：如果你的需求与Spring MVC的业务处理紧密相关（如检查用户是否登录），请使用拦截器，如果你的需求是更底层的、与框架无关的请求处理,请使用过滤器。

问2：为什么我在拦截器中通过@Autowired注入的Service对象是null？

答： 这个问题通常是因为拦截器实例没有被Spring容器管理，当你在配置类中使用registry.addInterceptor(new MyCustomInterceptor())时，new关键字创建的对象是一个普通的Java对象，Spring并不知道它的存在,因此无法为其注入依赖。

解决方法：确保你的拦截器类由Spring管理，在拦截器类上添加@Component注解，在配置类中，通过@Autowired将这个拦截器实例注入进来，最后将注入的实例添加到注册表中，这样,Spring在创建拦截器实例时就会自动完成依赖注入。