Java：chain.doFilter

chain.doFilter(request, response) 是 Java Servlet 过滤器Filter机制中的核心方法用于将请求传递给过滤器链中的下一个过滤器或者如果当前过滤器是链中的最后一个则将请求传递给目标资源如 Servlet、JSP 或静态资源。以下是关于 chain.doFilter 的详细解析1. 基本作用与工作原理‌传递控制权‌在 Filter 接口的 doFilter 方法中调用 chain.doFilter(request, response) 表示当前过滤器已完成其预处理逻辑允许请求继续向下传播。‌过滤器链执行‌Servlet 容器维护一个 FilterChain 对象。当调用 chain.doFilter 时容器会查找并执行链中的下一个过滤器。如果没有更多过滤器请求将被发送到最终的 Servlet 或资源。‌双向处理‌过滤器不仅可以处理进入的请求Request还可以处理返回的响应Response。代码位于 chain.doFilter 之前的部分在请求到达目标资源前执行代码位于 chain.doFilter 之后的部分在目标资源处理完毕、响应返回给客户端之前执行。2. 典型代码结构一个标准的过滤器实现通常包含以下结构Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)throws IOException, ServletException {// 1. 预处理逻辑请求阶段// 例如记录日志、检查权限、修改请求参数、设置字符编码等HttpServletRequest httpRequest (HttpServletRequest) request;System.out.println(请求URI: httpRequest.getRequestURI());//2. 放行请求交给下一个过滤器或目标资源chain.doFilter(request, response);// 3. 后处理逻辑响应阶段// 例如记录响应时间、压缩响应数据、修改响应头等HttpServletResponse httpResponse (HttpServletResponse) response;System.out.println(响应状态码: httpResponse.getStatus());}3. 关键注意事项A. 必须调用以完成请求如果在 doFilter 方法中‌没有‌调用 chain.doFilter(request, response)请求将在此处中断不会到达目标资源客户端通常会收到空白页面或超时错误。这通常用于拦截非法请求如未登录用户访问受保护资源此时过滤器应直接通过 response 对象返回错误信息或重定向。B. 请求与响应的包装如果需要修改请求或响应的内容例如修改请求参数或压缩响应输出不能直接传递原始的 request 和 response 对象而应该传递包装后的对象如 HttpServletRequestWrapper 或 HttpServletResponseWrapper。C. 异常处理chain.doFilter 可能会抛出 IOException 或 ServletException。在实际开发中通常需要在 try-catch-finally 块中调用它以确保即使后续处理发生异常当前过滤器也能执行必要的清理工作或记录错误日志。4. 在 Spring Security 中的应用在 Spring Security 中chain.doFilter 是责任链模式的核心体现。安全过滤器链Filter Chain由多个过滤器组成如认证过滤器、授权过滤器等。每个过滤器在执行完自己的安全逻辑后调用 chain.doFilter 将请求传递给下一个安全过滤器直到所有安全检查通过请求才到达应用程序的控制器。5. 常见应用场景‌身份验证与授权‌检查用户是否登录是否有权限访问特定资源。若未通过则不调用 chain.doFilter直接返回 401 或 403 状态码。‌日志记录‌在调用 chain.doFilter 前后记录请求的开始时间和结束时间计算处理耗时。‌字符编码设置‌在请求到达 Servlet 之前统一设置请求和响应的字符编码如 UTF-8防止乱码。‌跨域处理CORS‌添加必要的 CORS 响应头允许跨域请求。