一个粗人 發表於 2026-1-12 10:16:03

SpringMvc(Interceptor,Filter)实现方案

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>1. 过滤器 (Filter)</li><ul class="second_class_ul"><li>实现方案一：通过@WebFilter注解（Servlet 原生）</li><li>实现方案二：通过FilterRegistrationBean（Spring Boot统一管理生命周期&nbsp;推荐）</li></ul><li>2. 拦截器 (Interceptor)</li><ul class="second_class_ul"><li>需要继承/实现的类</li><li>注册拦截器</li></ul><li>3. 核心区别对比表</li><ul class="second_class_ul"><li>简单总结：</li></ul><li>为什么跨域请求要通过过滤器实现？</li><ul class="second_class_ul"></ul><li>1. 预检请求（OPTIONS）的拦路虎</li><ul class="second_class_ul"></ul><li>2. 为什么选择过滤器的三大理由</li><ul class="second_class_ul"><li>① 执行时机最早（最核心原因）</li><li>② 解决权限框架（Security/Shiro）的冲突</li><li>③ 覆盖范围广</li></ul><li>3. 实现代码对比</li><ul class="second_class_ul"><li>过滤器方案（推荐）</li></ul><li>总结</li><ul class="second_class_ul"></ul></ul></div><p>在 Java Web 开发中，<strong>过滤器 (Filter)</strong> 和 <strong>拦截器 (Interceptor)</strong> 都是常用的 AOP（面向切面编程）实现方式，但它们所属的框架层级和执行时机有很大不同。</p>
<p>我们可以把它们想象成进入大楼的<strong>保安（过滤器）和进入办公室前的秘书（拦截器）</strong>。</p>
<p class="maodian"></p><h2>1. 过滤器 (Filter)</h2>
<p>过滤器属于 <strong>Servlet 规范</strong>，它位于所有 Servlet 之前。它可以对几乎所有的请求（HTML、图片、JS、路径等）进行预处理。</p>
<p class="maodian"></p><h3>实现方案一：通过@WebFilter注解（Servlet 原生）</h3>
<p>这是最简单、最直接的方式，不需要额外的配置类。</p>
<ul><li><strong>实现步骤</strong>：
<ul><li>实现 <code>jakarta.servlet.Filter</code> 接口。</li><li>重写 <code>doFilter</code> 方法。</li><li>在类上标注 <code>@WebFilter(urlPatterns = &quot;/*&quot;)</code>。</li><li>在启动类上加 <code>@ServletComponentScan</code>。</li></ul></li></ul>
<p class="maodian"></p><h3>实现方案二：通过FilterRegistrationBean（Spring Boot统一管理生命周期&nbsp;推荐）</h3>
<p>如果你需要更精细地控制过滤器的执行顺序（Order），或者你的过滤器是第三方库提供的，这种方案最合适。</p>
<ul><li><strong>实现步骤</strong>：
<ul><li>编写一个普通的类实现 <code>Filter</code> 接口。</li><li>创建一个配置类（标注 <code>@Configuration</code>）。</li><li>定义一个 <code>Bean</code> 返回 <code>FilterRegistrationBean</code> 实例。</li></ul></li></ul>
<div class="jb51code"><pre class="brush:java;">@Bean
public FilterRegistrationBean&lt;MyFilter&gt; registrationBean() {
    FilterRegistrationBean&lt;MyFilter&gt; bean = new FilterRegistrationBean&lt;&gt;();
    bean.setFilter(new MyFilter()); // 设置过滤器
    bean.addUrlPatterns("/api/*");// 设置拦截路径
    bean.setOrder(1);               // 设置优先级，数字越小越靠前
    return bean;
}</pre></div>
<p class="maodian"></p><h2>2. 拦截器 (Interceptor)</h2>
<p>拦截器属于 <strong>Spring MVC 框架</strong>。它只能拦截发送到 Controller 的请求。因为它在 Spring 容器中，所以它可以直接使用 Spring 注入的对象（比如 <code>Service</code>）。</p>
<p class="maodian"></p><h3>需要继承/实现的类</h3>
<ul><li><strong>实现接口</strong>：<code>org.springframework.web.servlet.HandlerInterceptor</code>。</li><li><strong>主要方法</strong>：<ul><li><code>preHandle</code>：在 Controller 执行前调用（常用作权限校验）。</li><li><code>postHandle</code>：Controller 执行后，视图渲染前调用。</li><li><code>afterCompletion</code>：整个请求结束（视图渲染后）调用，常用于清理资源。</li></ul></li></ul>
<p class="maodian"></p><h3>注册拦截器</h3>
<p>实现拦截器后，必须将其注册到 Spring MVC 的配置中：</p>
<ul><li>继承 <code>WebMvcConfigurer</code> 接口。</li><li>重写 <code>addInterceptors</code> 方法。</li></ul>
<p class="maodian"></p><h2>3. 核心区别对比表</h2>
<table><thead><tr><td><strong>特性</strong></td><td><strong>过滤器 (Filter)</strong></td><td><strong>拦截器 (Interceptor)</strong></td></tr></thead><tbody><tr><td><strong>所属框架</strong></td><td>Servlet 容器 (如 Tomcat)</td><td>Spring MVC 框架</td></tr><tr><td><strong>实现接口</strong></td><td><code>jakarta.servlet.Filter</code></td><td><code>HandlerInterceptor</code></td></tr><tr><td><strong>拦截范围</strong></td><td>几乎所有请求 (URL 匹配即可)</td><td>仅针对 Controller 的请求</td></tr><tr><td><strong>注入能力</strong></td><td>较难直接注入 Spring Bean</td><td>完美支持注入 Bean</td></tr><tr><td><strong>执行时机</strong></td><td>在 Servlet 之前执行</td><td>在 Servlet 之后，Controller 之前执行</td></tr><tr><td><strong>主要用途</strong></td><td>编码设置、敏感词过滤、全局压缩</td><td>权限检查、日志记录、参数预处理</td></tr></tbody></table>
<p class="maodian"></p><h3>简单总结：</h3>
<ul><li><strong>过滤器</strong>：适合做底层的、通用的操作（如：字符编码、请求跨域、全局加密）。</li><li><strong>拦截器</strong>：适合做业务相关的操作（如：检查是否登录、接口权限控制、记录操作日志）。</li></ul>
<p class="maodian"></p><h2>为什么跨域请求要通过过滤器实现？</h2>
<p>其实跨域（CORS）既可以通过**过滤器（Filter）<strong>实现，也可以通过</strong>拦截器（Interceptor）**或者 Spring 提供的 <code>@CrossOrigin</code> 注解实现。</p>
<p>但在实际生产中，<strong>绝大多数架构师会首选过滤器</strong>。这主要源于跨域请求的一个特殊机制：<strong>预检请求（Preflight Request）</strong>。</p>
<p class="maodian"></p><h2>1. 预检请求（OPTIONS）的拦路虎</h2>
<p>当浏览器发现你在发起一个&ldquo;复杂请求&rdquo;（比如带了自定义 Header 或 Content-Type 为 <code>application/json</code>）时，它会先自动发送一个 <strong>OPTIONS</strong> 方法的探测请求。</p>
<ul><li><strong>过滤器的优势</strong>：由于过滤器在 <strong>Servlet 容器</strong>的最外层，它能在请求到达 Spring MVC 的 <code>DispatcherServlet</code> 之前，就识别出这是一个 OPTIONS 请求，并直接返回允许跨域的响应头（200 OK）。</li><li><strong>拦截器的劣势</strong>：拦截器工作在 Spring MVC 内部。如果你的 OPTIONS 请求因为某些安全配置或权限校验没能通过 <code>DispatcherServlet</code> 的映射，拦截器可能根本不会执行。这会导致预检请求失败，浏览器直接拦截掉后续的正式请求。</li></ul>
<p class="maodian"></p><h2>2. 为什么选择过滤器的三大理由</h2>
<p class="maodian"></p><h3>① 执行时机最早（最核心原因）</h3>
<p>跨域配置本质上是给 HTTP 响应头加上 <code>Access-Control-Allow-Origin</code> 等字段。</p>
<ul><li><strong>过滤器</strong>在整个过滤链的最前端。如果请求跨域失败，直接在过滤器层级就&ldquo;挡回去&rdquo;或&ldquo;处理掉&rdquo;了，不会浪费后续的业务逻辑资源（如数据库连接、权限检查）。</li></ul>
<p class="maodian"></p><h3>② 解决权限框架（Security/Shiro）的冲突</h3>
<p>如果你的项目中使用了 <strong>Spring Security</strong>，它本身就是通过一系列过滤器实现的。</p>
<ul><li>如果你把跨域放在<strong>拦截器</strong>里，由于拦截器的执行晚于 Spring Security 的过滤器，Spring Security 会在拦截器生效前发现请求没带 Token 或不符合安全规则，直接返回 403。</li><li>此时浏览器因为没收到跨域响应头，会报一个&ldquo;CORS error&rdquo;，而隐藏了真正的&ldquo;403 Forbidden&rdquo;错误，导致前端无法准确定位问题。</li></ul>
<p class="maodian"></p><h3>③ 覆盖范围广</h3>
<p>过滤器是针对 URL 模式拦截的。如果你的项目里既有 Spring MVC 的 Controller，又有一些原生的 Servlet，或者静态资源，过滤器可以一把抓，统一处理所有资源的跨域问题。</p>
<p class="maodian"></p><h2>3. 实现代码对比</h2>
<p class="maodian"></p><h3>过滤器方案（推荐）</h3>
<p>这种方式利用 Spring 提供的 <code>CorsFilter</code>，通常配合 <code>FilterRegistrationBean</code> 使用，优先级设为最高。</p>
<div class="jb51code"><pre class="brush:java;">@Bean
public FilterRegistrationBean&lt;CorsFilter&gt; corsFilter() {
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowCredentials(true);
    config.addAllowedOriginPattern("*"); // 允许所有来源
    config.addAllowedHeader("*");      // 允许所有Header
    config.addAllowedMethod("*");      // 允许所有方法
    source.registerCorsConfiguration("/**", config);
    FilterRegistrationBean&lt;CorsFilter&gt; bean = new FilterRegistrationBean&lt;&gt;(new CorsFilter(source));
    bean.setOrder(Ordered.HIGHEST_PRECEDENCE); // 确保在最前端执行
    return bean;
}</pre></div>
<p class="maodian"></p><h2>总结</h2>
<p>跨域选择过滤器，是因为它能<strong>在业务逻辑和安全框架之前处理 OPTIONS 请求</strong>。就像在大楼的**正门口（过滤器）<strong>贴上&ldquo;欢迎光临&rdquo;的告示，比等客人进了</strong>办公室（拦截器）**才说欢迎要高效且稳妥得多。</p>
<p>到此这篇关于SpringMvc(Interceptor,Filter)实现方案的文章就介绍到这了,更多相关SpringMvc Interceptor,Filter内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>
                           
                            <div class="art_xg">
                              <b>您可能感兴趣的文章:</b><ul><li>浅谈SpringMVC的拦截器（Interceptor）和Servlet 的过滤器（Filter）的区别与联系 及SpringMVC 的配置文件</li><li>浅谈SpringMVC中Interceptor和Filter区别</li><li>SpringMVC的处理器拦截器HandlerInterceptor详解</li><li>SpringMVC中的ConversionServiceExposingInterceptor工具类解析</li><li>SpringMVC中的ResourceUrlProviderExposingInterceptor详解</li><li>SpringMVC&nbsp;Interceptor拦截器使用教程</li><li>springMVC拦截器HandlerInterceptor用法代码示例</li><li>详解SpringMVC中使用Interceptor拦截器</li></ul>
                            </div>

                        </div>
                        <!--endmain-->
頁: [1]
查看完整版本: SpringMvc(Interceptor,Filter)实现方案