Spring Boot中的拦截器配置

关注

原创最新推荐文章于 2026-04-03 12:14:44 发布 2.1k 阅读 AI 写同款· GEO 优化 ›

Spring Boot中的拦截器配置

大家好，我是免费搭建查券返利机器人省钱赚佣金就用微赚淘客系统3.0的小编，也是冬天不穿秋裤，天冷也要风度的程序猿！今天我们来聊聊Spring Boot中的拦截器配置。拦截器是处理HTTP请求的一种机制，类似于Servlet过滤器，但它更强大且使用更加灵活。在Spring Boot中，拦截器用于在请求到达控制器之前和请求完成之后进行一些预处理和后处理操作。接下来，我们将深入探讨如何在Spring Boot中配置和使用拦截器。

一、什么是拦截器？

拦截器（Interceptor）是一种动态拦截处理机制，允许在请求到达控制器之前和请求返回视图之后执行特定的逻辑。它通常用于以下场景：

日志记录
用户身份验证
参数检查
性能监控
请求重定向

拦截器与过滤器的不同之处在于，拦截器是基于框架（如Spring MVC）的，而过滤器则是基于Servlet规范的。

二、Spring Boot中配置拦截器

在Spring Boot中，配置拦截器非常简单。我们需要创建一个实现HandlerInterceptor接口的类，并将其注册到Spring MVC配置中。下面是一个简单的示例：

package cn.juwatech.interceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

public class MyInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 在请求处理之前进行调用（Controller方法调用之前）
        System.out.println("Pre Handle method is Calling");
        return true; // 如果返回false，拦截请求
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
                           ModelAndView modelAndView) throws Exception {
        // 请求处理之后进行调用，但是在视图被渲染之前（Controller方法调用之后）
        System.out.println("Post Handle method is Calling");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
            throws Exception {
        // 在整个请求结束之后被调用，也就是在DispatcherServlet渲染了对应的视图之后执行
        System.out.println("Request and Response is completed");
    }
}

三、注册拦截器

在创建了拦截器类之后，我们需要将其注册到Spring MVC中。可以通过继承WebMvcConfigurerAdapter并重写addInterceptors方法来实现：

package cn.juwatech.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import cn.juwatech.interceptor.MyInterceptor;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注册自定义拦截器，添加拦截路径和排除拦截路径
        registry.addInterceptor(new MyInterceptor()).addPathPatterns("/**").excludePathPatterns("/login", "/logout");
    }
}

四、拦截器链

Spring MVC支持多个拦截器，可以将多个拦截器组成拦截器链。在处理请求时，拦截器链按照其注册的顺序执行。我们可以添加多个拦截器到InterceptorRegistry中：

package cn.juwatech.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import cn.juwatech.interceptor.FirstInterceptor;
import cn.juwatech.interceptor.SecondInterceptor;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注册多个拦截器
        registry.addInterceptor(new FirstInterceptor()).addPathPatterns("/**");
        registry.addInterceptor(new SecondInterceptor()).addPathPatterns("/**");
    }
}

五、拦截器的实际应用

在实际开发中，拦截器有广泛的应用场景。例如，我们可以使用拦截器实现简单的日志记录功能：

package cn.juwatech.interceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.HandlerInterceptor;

public class LoggingInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("Request URL: " + request.getRequestURL());
        System.out.println("Request Method: " + request.getMethod());
        return true;
    }
}