spring boot 的全局异常处理机制无法直接捕获监听器（如 servletcontextlistener）的异常，因为监听器的生命周期早于 dispatcherservlet 和 handlerexceptionresolver。要解决这个问题，必须实现 servletcontextlistener 接口并在其 contextinitialized 方法中注册一个自定义的 errorpage，将错误页面指向 spring mvc 能够处理的 controller。
如何配置全局错误映射以接管监听器异常
通过编程式注册 ErrorPage 对象，可以强制容器在发生未捕获异常时转发到指定的 URL，从而让 Spring MVC 介入处理。具体做法是在一个实现了 ServletContextListener 的类中，获取 ServletContext 并调用 addErrorPage 方法，指定异常类型或错误代码对应的路径，例如 /error 或自定义的 /global-error。
import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
@WebListener
public class ErrorConfigListener implements ServletContextListener {
@Override
public void contextInitialized(ServletContextEvent sce) {
ServletContext ctx = sce.getServletContext();
// 将未捕获的异常转发给 Spring 的 /error 端点
ctx.addErrorPage(new javax.servlet.ErrorPage(Exception.class, "/error"));
// 或者针对特定业务异常
// ctx.addErrorPage(new javax.servlet.ErrorPage(MyBusinessException.class, "/api/error"));
}
@Override
public void contextDestroyed(ServletContextEvent sce) {
}
}
上述代码中，@WebListener 注解确保该监听器在应用启动时被加载。当任何地方抛出未处理的 Exception 时，Servlet 容器会拦截该异常，并根据配置将其转发至 /error。此时，Spring Boot 内置的 BasicErrorController 或自定义的 @ExceptionHandler 将接管后续流程，返回 JSON 或 HTML 响应。
如何在 Spring MVC 中统一处理这些转发的异常
一旦异常被转发到 Spring MVC 的路径，就可以利用 @ControllerAdvice 和 @ExceptionHandler 进行统一处理。需要创建一个全局异常处理器类，定义针对特定异常类型的处理方法，并确保该方法能正确识别请求来源是内部转发还是外部请求。
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
public ResponseEntity<map object>> handleAllExceptions(Exception ex) {
Map<string object> body = new HashMap();
body.put("status", HttpStatus.INTERNAL_SERVER_ERROR.value());
body.put("message", "系统发生未知错误: " + ex.getMessage());
body.put("timestamp", System.currentTimeMillis());
return new ResponseEntity(body, HttpStatus.INTERNAL_SERVER_ERROR);
}
@ExceptionHandler(MyBusinessException.class)
public ResponseEntity<map object>> handleBusinessException(MyBusinessException ex) {
Map<string object> body = new HashMap();
body.put("status", HttpStatus.BAD_REQUEST.value());
body.put("message", ex.getMessage());
return new ResponseEntity(body, HttpStatus.BAD_REQUEST);
}
}</string></map></string></map>
在这个控制器 advice 中，handleAllExceptions 方法捕获所有未处理的异常。由于监听器异常是通过转发过来的，Spring 的 DispatcherServlet 会像处理普通请求一样处理它。如果需要在日志中区分异常来源，可以在 HttpServletRequest 中检查 javax.servlet.error.exception 属性，该属性在转发时会包含原始的异常对象。
监听器初始化阶段抛出的异常如何被记录
在 contextInitialized 方法执行期间，如果代码本身抛出异常且未被 try-catch 包裹，Servlet 容器通常会直接终止应用启动，而不会经过 ErrorPage 机制。因此，必须在监听器内部显式捕获异常并记录日志，或者将关键初始化逻辑放入 Spring Bean 的生命周期回调中。
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
@WebListener
public class SafeInitListener implements ServletContextListener {
private static final Logger log = LoggerFactory.getLogger(SafeInitListener.class);
@Override
public void contextInitialized(ServletContextEvent sce) {
try {
ServletContext ctx = sce.getServletContext();
ctx.addErrorPage(new javax.servlet.ErrorPage(Exception.class, "/error"));
// 模拟可能出错的初始化操作
performCriticalInitialization(ctx);
log.info("Application initialized successfully.");
} catch (Exception e) {
log.error("Failed to initialize application context", e);
// 可以选择重新抛出以阻止启动，或静默处理
throw new RuntimeException("Initialization failed", e);
}
}
private void performCriticalInitialization(ServletContext ctx) {
// 实际初始化逻辑
}
@Override
public void contextDestroyed(ServletContextEvent sce) {
}
}
这段代码展示了在监听器中安全初始化的最佳实践。通过在 try-catch 块中包裹初始化逻辑，可以防止因初始化失败导致的应用崩溃，同时确保 ErrorPage 已经注册。如果初始化失败，异常会被记录并重新抛出，此时应用将无法启动，这是更安全的做法。如果希望应用继续运行但标记错误状态，则不应重新抛出异常，而是设置一个标志位供后续请求检查。
