Spring Boot嵌入式Tomcat中Application Context初始化失败如何终止？

这是预期行为吗？ #

没错，这确实是Spring Boot嵌入式Tomcat场景下的默认预期行为。

背后的原因是：嵌入式Tomcat的启动流程和Spring应用上下文（ApplicationContext）的初始化是分阶段执行的——Tomcat的端口监听逻辑会在Spring上下文初始化之前就启动，目的是尽可能快地让服务“看起来可用”。但如果后续上下文初始化失败（比如数据库连接失败、Liquibase迁移出错、循环依赖等），Spring并没有自动终止已经启动的Tomcat，此时Tomcat虽然在监听端口，但因为没有任何Spring控制器或路由被加载，所以所有请求都会返回404 NOT FOUND。

如何在上下文初始化失败时终止Spring Boot和Tomcat？ #

有两种常用方案，你可以根据需求选择：

方案1：通过配置快速解决（最简单） #

在你的application.properties或application.yml中添加以下配置，让Spring Boot在应用启动失败时自动退出JVM，从而终止Tomcat：

application.properties：

spring.main.exit-on-failure=true

application.yml：

spring:
  main:
    exit-on-failure: true

这个配置的作用是：当SpringApplication.run()检测到上下文初始化失败时，会自动调用System.exit(1)，JVM退出后，嵌入式Tomcat的监听进程也会随之终止，不会再继续占用8080端口。

方案2：自定义监听器（更灵活） #

如果需要在失败时执行额外逻辑（比如自定义日志、资源清理等），可以实现ApplicationListener<ApplicationFailedEvent>来监听启动失败事件，手动关闭上下文并终止JVM：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.event.ApplicationFailedEvent;
import org.springframework.context.ApplicationListener;
import org.springframework.context.ConfigurableApplicationContext;

@SpringBootApplication
public class YourApplication {

    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(YourApplication.class);
        
        // 添加启动失败监听器
        app.addListener((ApplicationListener<ApplicationFailedEvent>) event -> {
            ConfigurableApplicationContext context = event.getApplicationContext();
            if (context != null) {
                context.close(); // 关闭Spring上下文
            }
            // 记录失败日志（可根据需求自定义）
            System.err.println("应用上下文初始化失败，正在终止Tomcat和JVM...");
            // 终止JVM，确保Tomcat完全停止
            System.exit(1);
        });
        
        app.run(args);
    }
}

这样当上下文初始化失败时，监听器会触发，先关闭Spring上下文，再强制退出JVM，彻底终止Tomcat的端口监听。

内容的提问来源于stack exchange，提问作者Mykola Yashchenko