如何在BeanCreationException发生时停止Spring Boot应用？

方法1：用ApplicationRunner/CommandLineRunner执行初始化并主动终止 #

创建实现ApplicationRunner或CommandLineRunner的组件，在run方法中执行初始化逻辑，一旦抛出异常，直接调用System.exit(1)终止JVM，确保应用彻底停止。通过@Order(Ordered.HIGHEST_PRECEDENCE)保证该任务优先执行。

示例代码：

@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class StartupInitializer implements ApplicationRunner {

    @Override
    public void run(ApplicationArguments args) throws Exception {
        try {
            // 执行核心初始化任务
            performCriticalInit();
        } catch (Exception e) {
            System.err.println("初始化失败，应用即将终止：" + e.getMessage());
            System.exit(1);
        }
    }

    private void performCriticalInit() throws Exception {
        // 你的初始化逻辑，失败时抛出异常
        throw new RuntimeException("初始化任务执行失败");
    }
}

方法2：@PostConstruct结合启动失败配置 #

在关键Bean上用@PostConstruct执行初始化，同时通过配置强制Spring Boot在上下文刷新失败时退出。如果之前构造方法抛异常但应用未停止，大概率是Spring Boot的容错配置导致，添加以下配置即可：

在application.properties中添加：

spring.main.exit-on-refresh-failure=true

对应的Bean代码：

@Component
public class CriticalInitBean {

    @PostConstruct
    public void init() throws Exception {
        performCriticalInit();
    }

    private void performCriticalInit() throws Exception {
        // 初始化逻辑，失败抛异常
        throw new RuntimeException("关键Bean初始化失败");
    }
}

方法3：实现SmartLifecycle接口控制启动 #

通过SmartLifecycle接口，在start方法中执行初始化，失败时直接终止应用：

@Component
public class LifecycleInitializer implements SmartLifecycle {
    private boolean isRunning = false;

    @Override
    public void start() {
        try {
            performCriticalInit();
            isRunning = true;
        } catch (Exception e) {
            System.err.println("初始化失败，应用终止：" + e.getMessage());
            System.exit(1);
        }
    }

    private void performCriticalInit() throws Exception {
        throw new RuntimeException("初始化失败");
    }

    @Override
    public void stop() {
        isRunning = false;
    }

    @Override
    public boolean isRunning() {
        return isRunning;
    }
}

关键说明 #

• 若构造方法抛BeanCreationException但应用未停止，检查是否配置了spring.main.allow-bean-definition-overriding=true等容错项，添加spring.main.exit-on-refresh-failure=true可强制上下文初始化失败时退出。
• 优先推荐ApplicationRunner结合System.exit(1)的方式，启动阶段执行逻辑明确，终止行为可控。

内容的提问来源于stack exchange，提问作者Paul Wellner Bou