Java过滤器中可通过try-catch包裹chain.doFilter()捕获链内同步异常，但需检查response.isCommitted()避免二次提交异常；异步场景须用AsyncListener.onError处理。
Java过滤器中无法直接“捕获”下游Servlet或后续过滤器抛出的异常，因为异常发生在过滤器链执行完毕之后（即chain.doFilter()调用之后），而此时过滤器的doFilter()方法已返回。真正可行的方式是**在过滤器中包裹chain.doFilter()调用，并用try-catch拦截其执行过程中抛出的异常**——但要注意：这仅对doFilter内部（如同步调用、未异步化）抛出的异常有效。
在doFilter中用try-catch捕获链内异常
这是最常用且有效的做法。将chain.doFilter(request, response)放入try块中，异常会在其执行期间（如目标Servlet抛出RuntimeException）被当前过滤器捕获。
- 必须确保没有提前提交响应（如调用了
response.getWriter().write()或response.getOutputStream().write()），否则再尝试写错误页会触发IllegalStateException - 捕获异常后，可统一记录日志、设置错误状态码、转发到错误页或直接输出JSON错误响应
- 示例：
throws IOException, ServletException {
HttpServletRequest request = (HttpServletRequest) req;
HttpServletResponse response = (HttpServletResponse) res;
try {
chain.doFilter(request, response); // 异常在此处抛出并被捕获
} catch (Exception e) {
log.error("请求处理异常: {}", request.getRequestURI(), e);
response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
response.setContentType("application/json;charset=UTF-8");
response.getWriter().write("{\"code\":500,\"msg\":\"服务异常\"}");
}
}
避免响应已提交导致的二次异常
如果业务代码或下游组件（如Spring MVC）已向客户端写入部分响应，再在过滤器中写错误内容就会失败。
- 可在捕获异常前检查
response.isCommitted()，若为true则无法修改响应，只能记录日志 - 更稳妥的做法是使用
ContentCachingResponseWrapper（Spring提供）或自定义HttpServletResponseWrapper缓存输出，延迟提交，便于统一错误处理 - 非Spring环境可继承
HttpServletResponseWrapper，重写getWriter()/getOutputStream()，将内容暂存至字节数组
结合Spring的@ExceptionHandler不适用于过滤器
Spring的@ControllerAdvice和@ExceptionHandler只作用于DispatcherServlet分发后的Controller层异常，对过滤器中发生的异常或Filter链前期抛出的异常无效。
立即学习“Java免费学习笔记（深入）”；
- 过滤器属于Servlet规范层级，早于Spring MVC初始化，因此不能依赖Spring MVC的异常处理机制
- 若需统一异常处理，建议将核心逻辑封装进Service，并在Service层抛出自定义业务异常，再由顶层过滤器捕获；或改用Spring WebMvc的HandlerExceptionResolver（需配合DispatcherServlet）
- 纯Servlet项目推荐用上述try-catch + Wrapper方案；Spring Boot项目可考虑使用
@ControllerAdvice处理Controller异常，同时保留一个顶层过滤器兜底处理Filter链异常
注意异步请求的异常处理差异
对于开启异步支持（request.startAsync()）的场景，chain.doFilter()可能立即返回，实际处理在异步线程中进行，此时try-catch无法捕获后续异常。
- 需调用
asyncContext.start(Runnable)并在Runnable中try-catch - 或注册
AsyncListener，在onError(AsyncEvent)回调中处理异常 - 示例：
asyncContext.addListener(new AsyncListener() { public void onError(AsyncEvent event) { /* 处理异常 */ } });
基本上就这些。关键在于理解过滤器链的执行时机和响应生命周期，合理选择包裹方式与响应包装策略。不复杂但容易忽略提交状态和异步边界。
