ExecutorService如何优雅停机

在 Java 中，ExecutorService 的**优雅停机（Graceful Shutdown）**核心目标是：

不再接收新任务，但已提交的任务（包括正在执行和队列中等待的）尽量执行完，然后再释放线程资源。

下面从标准做法 → 进阶控制 → 常见坑三个层面说明。

一、标准优雅停机方式（推荐）

1️⃣ 基本三步法

ExecutorService executor = Executors.newFixedThreadPool(10);

// 1. 停止接收新任务
executor.shutdown();

try {
    // 2. 等待已有任务执行完毕（最多等 30 秒）
    if (!executor.awaitTermination(30, TimeUnit.SECONDS)) {
        // 3. 超时后强制关闭
        executor.shutdownNow();
    }
} catch (InterruptedException e) {
    // 被中断时，也尝试强制关闭
    executor.shutdownNow();
    Thread.currentThread().interrupt();
}

✅ 说明

• shutdown()
  • 不再接受新任务
  • 已提交任务继续执行
• awaitTermination()
  • 阻塞等待线程池结束
• shutdownNow()
  • 尝试中断正在执行的任务
  • 返回未开始执行的任务列表

二、更安全的停机模板（生产级）

public static void gracefulShutdown(ExecutorService executor, long timeout, TimeUnit unit) {
    executor.shutdown();
    try {
        if (!executor.awaitTermination(timeout, unit)) {
            executor.shutdownNow();
            executor.awaitTermination(timeout, unit);
        }
    } catch (InterruptedException e) {
        executor.shutdownNow();
        Thread.currentThread().interrupt();
    }
}

✅ 优点：

• 避免死等
• 中断后能恢复中断状态
• 适合 Spring / 容器关闭钩子

三、Spring 中的优雅停机（非常常见）

1️⃣ 使用 ThreadPoolTaskExecutor

@Bean
public Executor taskExecutor() {
    ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
    executor.setCorePoolSize(10);
    executor.setMaxPoolSize(20);
    executor.setQueueCapacity(100);
    executor.setWaitForTasksToCompleteOnShutdown(true);
    executor.setAwaitTerminationSeconds(30);
    executor.initialize();
    return executor;
}

✅ Spring 关闭时会自动：

• 停止接收新任务
• 等待任务完成（最多 30 秒）

四、任务如何配合优雅停机（关键）

✅ 任务必须“可中断”

while (!Thread.currentThread().isInterrupted()) {
    // 业务逻辑
}

或：

try {
    Thread.sleep(1000);
} catch (InterruptedException e) {
    Thread.currentThread().interrupt();
    break;
}

❌ 以下代码无法优雅停止：

while (true) {
    // 不检查中断
}

五、常见坑总结

六、一句话总结

优雅停机 = shutdown + awaitTermination + 可中断任务

如果你用的是：

• 普通线程池
• Spring Boot
• Tomcat / Netty 停机
• 定时任务（ScheduledExecutorService）

可以告诉我具体场景，我可以给你更精确的停机方案。