非REST场景下Spring Boot如何捕获所有异常并返回指定退出码

现有实现 #

当前应用为启动后自动执行单次任务的命令行程序，正常执行完成后主动触发应用退出，返回退出码0，核心代码如下：

@EventListener
public void onStart(ContextStartedEvent start){
    log.info("Application started.");
    doTheJob();
    log.info("Import finished.");
    applicationContext = start.getApplicationContext();
    SpringApplication.exit(applicationContext, () -> 0);
}

该正常流程的运行逻辑符合预期。

现存问题 #

• 当doTheJob()执行过程中抛出异常时，应用不会自动终止，进程会一直挂起
• 尝试新增标注@ExceptionHandler的全局异常处理方法，目标是捕获所有异常并触发返回-1退出码的退出逻辑，代码如下：

  @ExceptionHandler(value = Throwable.class)
  public void handleAll(){
      SpringApplication.exit(applicationContext, () -> -1);
  }
  

  但异常实际触发时，该处理方法完全没有被调用，无法达到预期效果。

问题根因 #

@ExceptionHandler不生效的核心原因是搞错了注解的适用边界：

• 它是Spring Web模块的专用异常处理组件，仅能拦截HTTP请求处理链路（从DispatcherServlet接收请求到控制器方法返回的全流程）中抛出的异常。非Web的命令行应用不会初始化Web层的异常处理机制，注解本身就没有生效的基础。
• 哪怕应用运行在Web容器中，事件监听器内抛出的异常完全脱离HTTP请求处理链路，根本不会走到@ExceptionHandler的拦截范围，永远不会被该方法捕获。

可落地实现方案 #

方案1：在监听器方法内直接加异常兜底 #

所有任务抛出的异常都来自onStart方法的调用栈，直接在方法内通过try-catch块统一捕获即可，无需依赖其他组件：

@EventListener
public void onStart(ContextStartedEvent start){
    log.info("Application started.");
    ConfigurableApplicationContext applicationContext = start.getApplicationContext();
    try {
        doTheJob();
        log.info("Import finished.");
        SpringApplication.exit(applicationContext, () -> 0);
    } catch (Throwable t) {
        // 打印完整异常堆栈，方便后续排查问题
        log.error("任务执行中断", t);
        // 主动退出应用，返回自定义非0退出码
        SpringApplication.exit(applicationContext, () -> 1);
    }
}

该写法无额外依赖，可以捕获所有从任务逻辑中抛出的异常（包含受检异常、运行时异常、OOM等Error类），逻辑直观可靠。

方案2：依赖Spring Boot默认启动错误处理机制 #

如果不想编写冗余的try-catch代码，可以不主动捕获异常：只要保证doTheJob()抛出的异常直接向上传播，不被中间逻辑吞掉，Spring Boot的启动流程会自动捕获启动阶段抛出的未处理异常，直接终止JVM进程并返回非0退出码，无需手动调用退出方法：

@EventListener
public void onStart(ContextStartedEvent start){
    log.info("Application started.");
    // 异常直接向上传播，不做捕获
    doTheJob();
    log.info("Import finished.");
    // 仅在正常流程完成时手动触发退出
    SpringApplication.exit(start.getApplicationContext(), () -> 0);
}

这种写法下，任务执行报错时，Spring Boot会自动打印完整异常堆栈，直接终止进程，默认返回非0退出码，符合命令行任务的运行规范，代码量最少。 #

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