如何在Spring Boot中捕获所有入口点的异常并确保日志记录？

要覆盖Spring Boot应用中所有入口点的异常捕获（包括@JmsListener、定时任务、异步方法等非Controller场景），可以通过以下组合方案实现，确保所有未处理的异常都能被记录：

1. 针对特定组件的异常处理器 #

不同Spring组件有各自的异常处理扩展点，需针对性配置：

• JMS监听器：实现JmsListenerErrorHandler接口并注册为Bean，捕获@JmsListener方法抛出的异常：

  @Component
  public class CustomJmsErrorHandler implements JmsListenerErrorHandler {
      private static final Logger log = LoggerFactory.getLogger(CustomJmsErrorHandler.class);
  
      @Override
      public Object handleError(Message<?> message, ListenerExecutionFailedException exception) {
          log.error("JMS监听器处理消息失败，消息内容: {}", message.getPayload(), exception);
          // 可按需添加重试、死信队列等逻辑
          throw exception;
      }
  }
  

• 异步方法：配置AsyncConfigurer，自定义异步任务的异常处理器：

  @Configuration
  @EnableAsync
  public class AsyncConfig implements AsyncConfigurer {
      private static final Logger log = LoggerFactory.getLogger(AsyncConfig.class);
  
      @Override
      public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
          return (ex, method, params) -> 
              log.error("异步方法执行失败，方法名: {}", method.getName(), ex);
      }
  }
  

• 定时任务：实现SchedulingConfigurer，为定时任务线程池配置异常处理器：

  @Configuration
  @EnableScheduling
  public class SchedulingConfig implements SchedulingConfigurer {
      private static final Logger log = LoggerFactory.getLogger(SchedulingConfig.class);
  
      @Override
      public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
          ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
          scheduler.setThreadNamePrefix("scheduled-task-");
          scheduler.setErrorHandler(t -> 
              log.error("定时任务执行失败", t)
          );
          scheduler.initialize();
          taskRegistrar.setTaskScheduler(scheduler);
      }
  }
  

2. 全局AOP切面捕获所有Bean方法异常 #

通过AOP切面拦截所有Spring管理Bean的方法调用，捕获未处理的异常，覆盖普通Bean的公共方法入口：

@Aspect
@Component
public class GlobalExceptionLoggingAspect {
    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionLoggingAspect.class);

    @Pointcut("within(@org.springframework.stereotype.Component *) || within(@org.springframework.stereotype.Service *)")
    public void springBeanPointcut() {}

    @AfterThrowing(pointcut = "springBeanPointcut()", throwing = "ex")
    public void logAfterThrowing(Throwable ex) {
        log.error("全局捕获到未处理异常", ex);
    }
}

注意：可通过调整Pointcut表达式缩小拦截范围，避免日志组件等内部Bean的循环调用问题。

3. 虚拟机级别的全局异常处理器 #

作为兜底方案，设置Thread.UncaughtExceptionHandler捕获所有线程中未被处理的异常：

@Configuration
public class GlobalUncaughtExceptionConfig {
    private static final Logger log = LoggerFactory.getLogger(GlobalUncaughtExceptionConfig.class);

    @PostConstruct
    public void setupUncaughtExceptionHandler() {
        Thread.setDefaultUncaughtExceptionHandler((thread, ex) -> 
            log.error("线程[{}]中捕获到未处理的异常", thread.getName(), ex)
        );
    }
}

此方案适合捕获绕过Spring机制的手动创建线程的异常。

4. 保留Controller层异常处理 #

继续使用@RestControllerAdvice处理Controller入口的异常，与上述方案互补：

@RestControllerAdvice
public class ControllerExceptionHandler {
    private static final Logger log = LoggerFactory.getLogger(ControllerExceptionHandler.class);

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleAllExceptions(Exception ex) {
        log.error("Controller入口捕获到异常", ex);
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body(new ErrorResponse("服务器内部错误"));
    }
}

通过以上方案组合，可覆盖Spring Boot应用中几乎所有入口点，确保所有抛出的异常都被记录。

内容的提问来源于stack exchange，提问作者Stian Jørgensrud