Java Web 请求处理链路：从 Filter 到 HandlerInterceptor 深度解析

• 初始化：容器调用 init(FilterConfig config)，仅执行一次
• 执行过滤：每次请求匹配 URL 时触发 doFilter()
• 销毁：容器关闭前调用 destroy()，释放资源

执行时机示例

public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain)
        throws IOException, ServletException {
    // 请求前处理：日志记录、权限校验
    System.out.println("Before processing request");
    // 放行请求至下一个 Filter 或目标资源
    chain.doFilter(req, resp);
    // 响应后处理：压缩、日志记录
    System.out.println("After processing response");
}

这段代码展示了 Filter 在请求处理前后插入逻辑的能力。通过 chain.doFilter() 控制流程继续，实现环绕式拦截。

基于 Filter 实现请求日志记录实战

在 Java Web 开发中，Filter 是处理 HTTP 请求的利器，常用于统一的日志记录。通过自定义 Filter，可以在请求进入业务逻辑前捕获关键信息。

核心实现步骤

• 实现 javax.servlet.Filter 接口
• 重写 doFilter 方法拦截请求
• 提取请求路径、IP、耗时等信息

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
        throws IOException, ServletException {
    HttpServletRequest req = (HttpServletRequest) request;
    long startTime = System.currentTimeMillis();
    // 记录请求信息
    log.info("Request: {} from {}", req.getRequestURI(), req.getRemoteAddr());
    
    chain.doFilter(request, response); // 继续执行
    
    // 记录响应耗时
    long duration = System.currentTimeMillis() - startTime;
    log.info("Response time: {} ms", duration);
}

上述代码通过 FilterChain 控制流程，在前后分别记录时间戳，实现完整的请求生命周期监控。参数说明：chain.doFilter() 是关键调用，确保请求继续传递至下一个组件。

使用 Filter 进行字符编码统一处理

为什么需要统一编码过滤器

Web 应用常因请求头缺失、表单提交方式差异或浏览器兼容性问题导致乱码。Filter 可全局拦截请求/响应，避免在每个 Servlet 中重复设置编码。

典型 UTF-8 编码 Filter 实现

public class CharacterEncodingFilter implements Filter {
    private String encoding = "UTF-8";

    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain)
            throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) resp;
        
        request.setCharacterEncoding(encoding); // 设置请求体解码（POST）
        response.setCharacterEncoding(encoding); // 设置响应体编码
        response.setContentType("text/html;charset=" + encoding);
        
        chain.doFilter(request, response);
    }
}

该 Filter 确保请求参数与响应内容均以 UTF-8 解析和输出；setCharacterEncoding() 仅对请求体生效（如 POST），对 URL 参数无效（需配合 Tomcat 配置 URIEncoding="UTF-8"）。

常见编码配置对比

Filter 链的顺序控制与性能影响分析

在 Java Web 应用中，Filter 链的执行顺序直接影响请求处理的效率与结果。容器根据 web.xml 中声明的顺序或注解配置决定 Filter 的调用次序，先声明的 Filter 先执行 doFilter 方法。

执行顺序配置示例

<filter-mapping>
    <filter-name>AuthenticationFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
<filter-mapping>
    <filter-name>LoggingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

上述配置中，AuthenticationFilter 优先于 LoggingFilter 执行，形成'前向'调用链。开发者需确保安全类 Filter 前置，避免未授权访问绕过。

性能影响分析

• Filter 数量增加将线性提升请求延迟
• 阻塞式操作（如日志落盘）会降低吞吐量
• 合理短路（如缓存命中直接返回）可优化性能

典型场景下 Filter 的异常处理策略

在 Web 应用中，Filter 常用于请求预处理与响应后置操作。面对异常情况，合理的处理机制至关重要。

异常分类与响应策略

常见的异常包括解析失败、权限不足与服务不可用。针对不同场景应返回对应的 HTTP 状态码：

• 400 Bad Request：请求格式错误
• 401 Unauthorized：认证信息缺失或无效
• 503 Service Unavailable：下游服务异常

代码实现示例

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
        throws IOException, ServletException {
    try {
        chain.doFilter(request, response); // 执行后续过滤器或目标资源
    } catch (IllegalArgumentException e) {
        ((HttpServletResponse) response).setStatus(400);
        response.getWriter().write("{\"error\": \"Invalid request\"}");
    } catch (SecurityException e) {
        ((HttpServletResponse) response).setStatus(401);
        response.getWriter().write("{\"error\": \"Unauthorized access\"}");
    }
}

该 Filter 捕获非法参数与安全异常，避免异常向上抛出导致容器返回 500 错误。通过手动设置状态码和输出 JSON 错误信息，提升接口友好性与可调试性。

HandlerInterceptor 的工作原理深度剖析

HandlerInterceptor 的三大方法调用流程

在 Spring MVC 中，HandlerInterceptor 接口定义了三个核心方法，控制请求处理的不同阶段。它们按照特定顺序执行，形成完整的拦截链条。

方法执行顺序与语义

拦截器的调用流程严格遵循以下顺序：

1. preHandle()：处理器执行前调用，返回布尔值决定是否继续
2. postHandle()：处理器执行后、视图渲染前调用
3. afterCompletion()：整个请求完成后调用，用于资源清理

典型代码实现

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    // 可用于权限校验
    return true; // 返回 false 则中断请求
}

public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
    // 可修改 ModelAndView 或记录处理时间
}

public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
    // 清理资源，无论是否异常都会执行
}

上述方法构成请求生命周期的完整切面，适用于日志记录、性能监控等横切关注点。

拦截器中 preHandle 的业务预处理应用

权限校验与上下文注入

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
    String token = request.getHeader("Authorization");
    if (!validateToken(token)) {
        response.sendError(HttpServletResponse.SC_UNAUTHORIZED);
        return false; // 阻断后续流程
    }
    User user = parseUserFromToken(token);
    RequestContextHolder.currentRequestAttributes()
            .setAttribute("currentUser", user, RequestAttributes.SCOPE_REQUEST);
    return true; // 放行
}

该方法在 Controller 执行前完成 JWT 解析与用户对象绑定，避免重复解析；request.getAttribute("currentUser") 可在后续 Handler 中直接获取。

常见预处理场景对比

利用 afterCompletion 实现资源清理与监控

在 Spring 事务管理中，afterCompletion 是 TransactionSynchronization 接口的关键方法，用于在事务完成（提交或回滚）后执行收尾操作，特别适用于资源释放与监控埋点。

典型应用场景

• 关闭手动创建的数据库连接或会话
• 清除线程本地变量（ThreadLocal）
• 记录事务执行时长与结果状态

代码示例

TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {
    private final long startTime = System.currentTimeMillis();

    @Override
    public void afterCompletion(int status) {
        long duration = System.currentTimeMillis() - startTime;
        String txnStatus = status == STATUS_COMMITTED ? "COMMITTED" : "ROLLED_BACK";
        log.info("Transaction finished: {}, duration: {} ms", txnStatus, duration);
        // 清理资源，如关闭流、释放锁等
    }
});

上述代码注册了一个事务同步器，在事务结束后自动记录执行时间并输出日志。参数 status 明确指示事务最终状态，便于区分提交与回滚路径，为监控系统提供精准数据源。

Filter 与 HandlerInterceptor 的对比与选型

执行位置差异：Servlet 容器层 vs Spring MVC 层

在 Web 请求处理流程中，执行位置的差异决定了责任划分与控制粒度。Servlet 容器作为底层运行环境，负责接收 HTTP 请求并调用相应的 Servlet 实例；而 Spring MVC 则运行于其上层，通过 DispatcherServlet 接入处理链。

执行阶段对比

• Servlet 容器层：解析 HTTP 报文，管理生命周期（init/service/destroy）
• Spring MVC 层：执行拦截器、处理器映射、数据绑定、视图渲染等高级功能

典型代码体现

protected void doService(HttpServletRequest req, HttpServletResponse resp) throws Exception {
    // DispatcherServlet 将请求委派给具体控制器
    handlerExecutionChain = getHandler(processedRequest);
    if (handler != null) {
        ModelAndView mv = handlerAdapter.handle(req, resp, handler);
    }
}

上述方法展示了 Spring MVC 如何在 Servlet 的 service 基础上封装更精细的调度逻辑，将原始请求转化为面向注解的控制器调用。

职责分层示意

功能边界对比：请求过滤与业务逻辑拦截

在系统架构中，请求过滤与业务逻辑拦截虽常被混淆，实则职责分明。前者聚焦于协议层的预处理，如身份验证、IP 黑名单校验；后者关注应用层的流程控制，例如权限校验、操作审计。

典型应用场景划分

• 请求过滤：适用于所有请求的统一前置处理，不依赖具体业务上下文
• 业务逻辑拦截：需访问服务层资源，基于用户角色或状态决策执行路径

功能边界对比表

性能开销评估与高并发场景下的选择建议

在高并发系统中，序列化机制的性能直接影响整体吞吐量和延迟表现。不同序列化方式在 CPU 占用、内存消耗和传输效率上差异显著。

常见序列化协议性能对比

对于 QPS 超过万级的场景，推荐使用 Protobuf 以降低网络开销和 GC 压力。在 Java 生态中，可通过 gRPC 或 Thrift 等框架集成此类二进制协议。

实际项目中协同使用的设计模式探讨

在复杂系统开发中，单一设计模式往往难以满足需求，多种模式的协同使用成为提升架构灵活性的关键。

策略与工厂模式的结合

当需要动态选择算法实现时，策略模式定义行为族，工厂模式负责实例化具体策略，二者结合可实现解耦与扩展。

public interface PaymentStrategy {
    void pay(double amount);
}

public class AlipayStrategy implements PaymentStrategy {
    public void pay(double amount) {
        System.out.println("支付宝支付：" + amount);
    }
}

public class PaymentFactory {
    public static PaymentStrategy getStrategy(String type) {
        return "alipay".equals(type) ? new AlipayStrategy() : new WechatPayStrategy();
    }
}

上述代码中，PaymentStrategy 定义支付行为，PaymentFactory 根据类型返回对应策略实例，便于客户端无需关心创建逻辑。

观察者与中介者协作

在事件驱动架构中，观察者模式处理对象间一对多依赖，中介者模式封装对象交互，避免显式引用，降低耦合度。

总结与最佳实践建议

构建可维护的微服务架构

在实际项目中，微服务的拆分应基于业务边界而非技术便利。例如，某电商平台将订单、支付和库存作为独立服务部署，通过 RPC 进行通信，显著提升了系统可扩展性。

配置管理的最佳方式

使用集中式配置中心（如 Consul 或 Spring Cloud Config）统一管理环境变量。避免将敏感信息硬编码在代码中。

• 开发环境使用独立命名空间隔离配置
• 所有配置变更需通过 CI/CD 流水线自动同步
• 启用配置版本控制与回滚机制

监控与告警策略

部署流程图： 代码提交 → 单元测试 → 镜像构建 → 安全扫描 → 准生产部署 → 自动化测试 → 生产蓝绿发布