spring boot 全局异常处理默认无法捕获就绪检查(health check)阶段的异常,因为此时 dispatcherservlet 尚未完全初始化。要解决这个问题,需要实现 applicationlistener 接口来监听应用启动失败事件,或者在 main 方法中通过 springapplication.run() 的返回值获取 configurableapplicationcontext 并注册自定义的 failureanalyzer。推荐使用 failureanalyzer,它能提供比通用异常处理器更友好的错误提示。

为什么全局异常处理器抓不到就绪检查异常
全局异常处理依赖于 DispatcherServlet 和 HandlerExceptionResolver,而这些组件是在应用上下文刷新(Context Refresh)阶段之后才初始化的。如果 Bean 创建或条件装配在刷新阶段失败,请求映射根本不存在,因此任何基于 HTTP 请求的全局异常拦截器都无效。此时应用处于“半死”状态,只有底层的事件机制能捕捉到错误。

import org.springframework.boot.diagnostics.AbstractFailureAnalyzer;
import org.springframework.boot.diagnostics.AnalysisResult;
import org.springframework.boot.diagnostics.FailureAnalysis;
public class CustomFailureAnalyzer extends AbstractFailureAnalyzer<illegalstateexception> {
@Override
protected FailureAnalysis analyze(Throwable rootFailure, AnalysisResult result) {
return new FailureAnalysis(
"Bean creation failed: " + rootFailure.getMessage(),
"Check your @Conditional properties or missing dependencies.",
rootFailure
);
}
}</illegalstateexception>
如何配置 FailureAnalyzer 以捕获特定异常
为了让 Spring Boot 自动识别并调用自定义的分析器,需要将其实例注册为 Spring 工厂中的 Bean,或者放在 META-INF/spring.factories (Spring Boot 2.x) / META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports (Spring Boot 3.x) 中。对于简单的本地调试,直接在配置类中声明一个 @Bean 即可生效,因为它会被添加到默认的 FailureAnalyzers 列表中。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class DiagnosticConfig {
@Bean
public CustomFailureAnalyzer customFailureAnalyzer() {
return new CustomFailureAnalyzer();
}
}
基于具体输入条件的异常分析结果
当程序中存在一个强制依赖但缺失的 Bean 时,例如 @Autowired private MissingService service; 而该 Service 未定义且无默认值,应用启动会抛出 BeanCreationException。此时,如果配置了上述的 CustomFailureAnalyzer,控制台将输出格式化后的错误信息,明确指出是哪个 Bean 创建失败以及建议的修复方向,而不是堆栈跟踪。











