java拦截器与过滤器区别

在 Java Web 开发中，过滤器（Filter）和拦截器（Interceptor）都用于在请求处理前后做一些通用处理，但它们的位置、作用范围、技术体系和能力有明显区别。

一、核心区别对比

二、执行顺序（典型流程）

请求
 ↓
Filter（过滤器）
 ↓
DispatcherServlet
 ↓
Interceptor.preHandle
 ↓
Controller
 ↓
Interceptor.postHandle
 ↓
Interceptor.afterCompletion
 ↓
Filter（响应）

三、过滤器（Filter）

特点

• 属于 Servlet 规范
• 在 Servlet 之前执行
• 可以拦截 所有 HTTP 请求

常见用途

• 字符编码设置
• 登录校验（粗粒度）
• 跨域处理（CORS）
• 请求/响应日志
• XSS / SQL 注入防护

示例

@WebFilter("/*")
public class EncodingFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain)
            throws IOException, ServletException {
        req.setCharacterEncoding("UTF-8");
        chain.doFilter(req, resp);
    }
}

四、拦截器（Interceptor）

特点

• 属于 Spring MVC
• 在 Controller 前后执行
• 只能拦截 进入 DispatcherServlet 的请求

常见用途

• 登录状态校验
• 权限控制
• 接口耗时统计
• 业务日志记录
• 参数预处理

示例

public class LoginInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response,
                             Object handler) {
        // 登录校验
        return true;
    }
}

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new LoginInterceptor())
                .addPathPatterns("/**")
                .excludePathPatterns("/login");
    }
}

五、怎么选？

✅ 用 Filter 的场景

• 需要在 Servlet 前处理
• 不依赖 Spring
• 处理静态资源、全局请求

✅ 用 Interceptor 的场景

• 已使用 Spring MVC
• 需要访问 Controller、Service
• 更细粒度的业务控制

六、一句话总结

Filter 是 Servlet 层的“门卫”，Interceptor 是 Spring MVC 层的“管家”。

如果你愿意，我也可以帮你画一张执行流程图或结合 Spring Boot 举例。