spring boot 启动失败异常无法通过全局异常处理器捕获,因为此时 web 容器尚未初始化,而 @controlleradvice 和 @exceptionhandler 仅作用于已启动的 mvc 环境。要处理启动阶段的错误,必须使用 errorpageregistrar 接口注册自定义的错误页面映射,或者在 main 方法中直接捕获 springapplication.run() 抛出的异常。

如何通过 ErrorPageRegistrar 配置启动失败后的默认行为?
通过实现 ErrorPageRegistrar 接口并注册为 Bean,可以在应用上下文完全启动后(或启动失败时由底层机制接管)定义错误页面的路径。这种方式适用于处理 HTTP 请求层面的错误,但对于纯启动阶段(如 BeanCreationException)导致的进程退出,它主要作为兜底策略存在。

import org.springframework.boot.web.server.ErrorPage;
import org.springframework.boot.web.server.ErrorPageRegistrar;
import org.springframework.boot.web.server.ErrorPageRegistry;
import org.springframework.stereotype.Component;
@Component
public class CustomErrorConfig implements ErrorPageRegistrar {
@Override
public void registerErrorPages(ErrorPageRegistry registry) {
ErrorPage error404 = new ErrorPage("/error-404");
ErrorPage error500 = new ErrorPage("/error-500");
registry.addErrorPages(error404, error500);
}
}
上述代码定义了当发生 404 或 500 错误时,将转发到对应的路径。注意,这并不能阻止 JVM 因启动异常而退出,它只是配置了 Tomcat 等容器的错误响应行为。
如何在 main 方法中直接捕获启动异常并执行清理逻辑?
最直接且有效的方式是在 main 方法中使用 try-catch 块包裹 SpringApplication.run()。这样可以在应用启动失败时立即获取异常对象,执行日志记录、资源清理或发送通知等操作,防止程序静默崩溃。

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
try {
SpringApplication.run(Application.class, args);
} catch (Exception e) {
System.err.println("Application failed to start: " + e.getMessage());
// 执行清理逻辑,如关闭数据库连接、发送告警等
cleanupResources();
System.exit(1);
}
}
private static void cleanupResources() {
System.out.println("Performing cleanup...");
}
}
该方案确保了无论启动过程中出现何种异常(包括依赖注入失败、端口占用等),都能被统一捕获并进行处理,是排查启动问题的首选方式。
启动失败时如何区分不同类型的异常以便针对性处理?
在 main 方法的 catch 块中,可以通过判断异常的具体类型来采取不同的处理策略。例如,BindException 通常表示配置文件绑定失败,而 BeanCreationException 则表示 Bean 创建过程中出错。通过 instanceof 检查,可以精确地定位问题根源。
import org.springframework.beans.factory.BeanCreationException;
import org.springframework.boot.context.properties.bind.BindException;
// ... 在 catch 块中
if (e instanceof BindException) {
System.err.println("Configuration binding error: " + e.getMessage());
} else if (e instanceof BeanCreationException) {
System.err.println("Bean creation failed: " + e.getMessage());
} else {
System.err.println("Unknown startup error: " + e.getMessage());
}
这种分类处理方式有助于快速定位问题,特别是在自动化部署环境中,可以根据异常类型触发不同的重试或回滚机制。











