Spring Boot关闭时异步任务卡住：setWaitForTasksToCompleteOnShutdown作用咨询

首先针对你的疑问给出明确结论：如果你仅配置了setWaitForTasksToCompleteOnShutdown(true)而未设置等待超时，若存在长时间运行/卡死的任务，容器确实会一直等待到任务执行完成才会终止；如果搭配了超时参数，则超过最大等待时间后会强制终止。

该配置的完整生效逻辑如下：

• 当设置为true时，Spring容器触发关闭流程后，线程池会先停止接收所有新提交的任务，随后：
  1. 等待所有正在执行中的任务运行结束
  2. 等待所有已经提交到队列中待执行的任务运行结束
  3. 若同时配置了setAwaitTerminationSeconds(秒数)，上述等待流程会有最长时间限制，超过设定的时长后，无论任务是否执行完成，线程池都会被强制销毁，容器继续关闭流程
  4. 若未配置setAwaitTerminationSeconds，默认值为0，代表无等待超时限制，会一直阻塞到所有任务执行完成再继续关闭容器
• 当设置为false（默认值）时，容器关闭时会直接调用线程池的shutdownNow()方法，中断所有正在执行的任务、清空队列中的待执行任务，直接销毁线程池。

你当前的代码仅开启了任务完成等待开关，未配置等待超时，生产环境建议两个参数搭配使用，避免因任务卡死导致容器无法正常关闭，示例配置如下：

@Bean
public TaskExecutor myAsyncTaskExecutor() {
  ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
  executor.setCorePoolSize(20);
  executor.setMaxPoolSize(30);
  executor.setQueueCapacity(50);
  executor.setWaitForTasksToCompleteOnShutdown(true);
  // 新增最大等待时长，示例为300秒，可根据业务场景调整
  executor.setAwaitTerminationSeconds(300);
  executor.setThreadNamePrefix("MY-ASYNC-TASK");
  executor.initialize();
  return executor;
}

注意事项 #

该配置仅对当前线程池管理的任务生效，若你在异步任务中主动创建了不受该线程池管理的子线程，这些子线程不会被纳入等待逻辑，容器关闭时会被强制中断。

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