spring boot 全局异常处理可以通过自定义 @controlleradvice 配合 @exceptionhandler 来捕获存活检查(如 /actuator/health)抛出的异常。具体做法是确保你的异常处理器能拦截到 runtimeexception 或具体的业务异常,并在配置中排除对 /actuator/** 路径的默认安全限制或过滤器干扰,从而让异常正常传播至全局处理器。

为什么存活检查异常常被忽略?
在 Spring Boot 应用中,/actuator/health 端点通常由 HealthEndpoint 处理。如果健康检查逻辑中抛出未捕获的异常,默认情况下,Spring Boot 可能会将其视为内部服务器错误并返回 500 状态码,但有时由于 WebMvcConfigurer 或特定的过滤器链配置,这些异常可能不会进入你定义的全局异常处理器。这通常是因为异常发生在 DispatcherServlet 之前,或者被 ErrorController 特殊处理了。

import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.Status;
import org.springframework.stereotype.Component;
@Component
public class CustomHealthIndicator implements HealthIndicator {
@Override
public Health health() {
// 模拟一个会抛出异常的存活检查
if (System.currentTimeMillis() % 2 == 0) {
throw new RuntimeException("Simulated health check failure");
}
return Health.up().build();
}
}
上述代码是一个自定义的健康指示器。当它抛出 RuntimeException 时,我们需要确保这个异常能被全局处理器捕获。默认情况下,Actuator 的异常处理可能独立于 MVC 的全局异常处理机制。
如何配置全局异常处理器以覆盖 Actuator?
要使全局异常处理器生效,你需要创建一个继承自 ResponseEntityExceptionHandler 或使用 @RestControllerAdvice 的类。关键在于,Actuator 默认使用独立的 Servlet 映射(如果启用了独立 Servlet),或者共享同一个 Servlet 但有不同的请求映射。对于大多数单 Servlet 应用,只需确保你的 @ControllerAdvice 没有被 excludeFilter 排除,并且能够处理 Exception 或其子类。

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(RuntimeException.class)
public ResponseEntity<String> handleRuntimeException(RuntimeException ex) {
return new ResponseEntity<>("Caught exception: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
}
}
这段代码定义了一个全局异常处理器。它捕获所有 RuntimeException 及其子类。当 CustomHealthIndicator 抛出异常时,如果该异常传播到了 MVC 层,这个处理器就会拦截它并返回自定义的响应。注意,如果 Actuator 运行在独立的 Servlet 容器中,你可能还需要为 Actuator 单独配置一个 @ControllerAdvice,或者将 Actuator 的配置合并到主 Servlet 中(通过 server.servlet.path 等配置调整)。
验证异常是否被正确捕获的具体方法
为了验证异常是否被正确捕获,你可以启动应用并使用 curl 或浏览器访问 /actuator/health。如果配置正确,你应该看到全局处理器返回的 JSON 或文本响应,而不是默认的 Spring Boot 错误页面。此外,检查日志输出,确认异常堆栈信息是否只打印一次,且没有重复的错误处理记录。


















