Spring Boot 应用关闭时需显式管理手动创建的线程池，推荐用@Bean的destroyMethod="shutdown"配合@PreDestroy中awaitTermination确保任务完成，定时线程池需启用waitForTasksToCompleteOnShutdown，且必须开启graceful shutdown。
Spring Boot 在应用关闭时不会自动关闭你手动 new 出来的线程池，必须显式声明销毁逻辑，否则任务会丢失、线程不退出、JVM 挂起。
用 @Bean 的 destroyMethod 属性
这是最简洁、推荐的方式。只要线程池类型有 public shutdown() 方法（如 ThreadPoolTaskExecutor、ThreadPoolTaskScheduler），Spring 就能在销毁 Bean 时自动调用：
- 配置示例（Java Config）：
@Bean(destroyMethod = "shutdown")
public ThreadPoolTaskExecutor asyncExecutor() {
ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
executor.setCorePoolSize(4);
executor.setMaxPoolSize(8);
executor.setQueueCapacity(100);
executor.setThreadNamePrefix("async-");
return executor;
}
- 注意：仅调用 shutdown() 是不够的，它只是拒绝新任务并让已有任务继续运行；真正等待完成需配合 awaitTermination（见下一条）
配合 awaitTermination 确保任务执行完
destroyMethod="shutdown" 只触发关闭动作，不阻塞等待。若想等所有任务结束再继续销毁流程，需在 shutdown 后主动调用 awaitTermination，并设置合理超时：
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 推荐用 @PreDestroy 编写完整关闭逻辑：
@Bean
public ThreadPoolTaskExecutor asyncExecutor() {
// ... 配置同上
return executor;
}
@PreDestroy
public void shutdownAsyncExecutor() throws InterruptedException {
asyncExecutor.shutdown();
if (!asyncExecutor.awaitTermination(60, TimeUnit.SECONDS)) {
log.warn("Async executor did not terminate in time, forcing shutdown...");
asyncExecutor.shutdownNow();
}
}
- 超时时间建议设为 30–60 秒，与 spring.lifecycle.timeout-per-shutdown-phase 保持一致
- awaitTermination 返回 false 表示超时，此时可选 shutdownNow() 强制终止（慎用，仅作兜底）
定时任务线程池要单独配置等待策略
ThreadPoolTaskScheduler 用于 @Scheduled，默认不等待任务完成。必须显式启用：
- 关键两步缺一不可：
- setWaitForTasksToCompleteOnShutdown(true)
- setAwaitTerminationSeconds(60)
@Bean
public ThreadPoolTaskScheduler taskScheduler() {
ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
scheduler.setPoolSize(4);
scheduler.setThreadNamePrefix("scheduled-");
scheduler.setWaitForTasksToCompleteOnShutdown(true);
scheduler.setAwaitTerminationSeconds(60);
return scheduler;
}
基础环境配置不能少
以上线程池关闭逻辑依赖 Spring Boot 的优雅停机机制开启：
- application.yml 中必须启用：
server:
shutdown: graceful
spring:
lifecycle:
timeout-per-shutdown-phase: 30s
- 该配置让 Web 容器先停止接收请求，再触发 Spring 的 doClose 流程（含 @PreDestroy 和 destroyMethod）
- 若未开启 graceful，整个销毁流程会被跳过，自定义关闭逻辑无效
