spring boot 全局异常处理默认无法捕获过滤器（filter）中抛出的异常，因为 filter 运行在 dispatcherservlet 之前，其异常不会进入 spring mvc 的异常处理链。要解决这个问题，需要在 filter 中手动将异常包装为 dispatchexception 并放入请求属性，或者使用 handlerexceptionresolver 进行解析。推荐做法是在 filter 中捕获异常后，通过 requestdispatcher 转发到错误页面或保留异常信息供后续处理。
为什么 Filter 异常不被 @ControllerAdvice 捕获
@ControllerAdvice 和 @ExceptionHandler 仅作用于 DispatcherServlet 分发的请求。Filter 在 Servlet 容器层面执行，若直接抛出异常，Tomcat 等容器会直接返回 500 错误页，Spring 的异常处理器根本收不到该异常。因此，必须改变异常的传递方式，使其进入 Spring 的管理范围。
如何在 Filter 中模拟异常进入 Spring 处理流程
可以通过将异常存入 request.setAttribute() 并设置特定属性名，然后在 Controller 或全局异常处理器中读取该属性来模拟处理。更优雅的方式是使用 HandlerExceptionResolver 接口，在 Filter 中调用其 resolveException 方法，这样可以将异常交给 Spring 配置的异常解析器链处理，包括 @ControllerAdvice 定义的处理器。
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
public class CustomFilter implements Filter {
private HandlerExceptionResolver exceptionResolver;
public CustomFilter(HandlerExceptionResolver exceptionResolver) {
this.exceptionResolver = exceptionResolver;
}
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
try {
chain.doFilter(request, response);
} catch (Exception e) {
// 将异常交给 Spring 的异常解析器处理
ModelAndView mv = exceptionResolver.resolveException(
(HttpServletRequest) request, response, null, e);
if (mv != null) {
mv.getWriter().write("Handled by Spring");
}
}
}
}
上述代码展示了如何在 Filter 中注入 HandlerExceptionResolver 并在捕获异常后调用其方法。这种方式确保了异常能够被 @ControllerAdvice 中的 @ExceptionHandler 方法捕获和处理，从而统一异常响应格式。注意，HandlerExceptionResolver 需要正确配置，通常 Spring Boot 会自动注册默认的解析器链。
基于自定义注解的具体问题：如何标记需特殊处理的异常
在实际项目中，可能需要对某些特定类型的异常进行特殊标记，例如记录日志或触发告警。可以在 Filter 中定义一个自定义注解 @SpecialException，并在 Filter 中检查异常是否带有该注解，从而决定是否调用 HandlerExceptionResolver 或进行其他处理。这种方法提高了异常处理的灵活性和可维护性。
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface SpecialException {
String value() default "";
}
通过自定义注解，开发者可以更精细地控制异常的处理逻辑，确保只有符合特定条件的异常才会被特殊处理，而其他异常则按默认流程处理。这种设计模式有助于构建更加健壮和灵活的异常处理体系。
