Java线程池优雅关闭需先调用shutdown()停止接收新任务，再用awaitTermination()等待任务自然结束；超时后可调用shutdownNow()强制中断，但要求任务自身响应中断。
在 Java 中，线程池关闭时调用 awaitTermination 是实现“优雅等待”的核心手段——它不会强行中断运行中的任务，而是给正在执行的任务留出合理收尾时间，超时后才考虑进一步处理。
理解 shutdown + awaitTermination 的协作逻辑
shutdown() 本身只是停止接收新任务，并将已提交但未开始执行的任务保留在队列中；它**不中断**正在运行的线程。真正等待任务结束靠的是 awaitTermination(long timeout, TimeUnit unit)，它会阻塞当前线程，直到所有任务完成、线程池彻底终止，或超时发生。
- 必须先调用
shutdown()（或shutdownNow()，但后者会尝试中断任务，通常不用于“优雅”场景） -
awaitTermination返回true表示线程池已完全终止；返回false表示超时，此时线程池可能仍在运行部分任务 - 超时值不是越长越好，需结合业务任务最长预期执行时间设定（比如 30 秒、2 分钟）
标准写法：带超时重试与兜底处理
一次 awaitTermination 可能因网络延迟、GC 暂停等短暂原因未及时返回，建议配合简单重试；更重要的是，超时后要明确后续动作（如记录日志、强制关闭或抛异常），避免程序卡死或资源泄漏。
- 先调用
executor.shutdown() - 循环调用
awaitTermination，每次等待一段时间（例如 10 秒），总超时控制在合理范围内（如 60 秒） - 若最终未终止，可选择：记录警告日志、调用 shutdownNow() 强制中断剩余任务（注意：这会引发
InterruptedException，需确保任务代码能正确响应中断）
关键细节：任务必须响应中断
awaitTermination 的“优雅”前提是任务自身支持中断。如果任务里有 while(true) 循环、阻塞 IO 或忽略 Thread.interrupted()，即使线程池调用了 shutdownNow()，它也可能永远不退出。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 在长时间运行的循环中定期检查
Thread.currentThread().isInterrupted() - 使用可中断的 API，比如
BlockingQueue.poll(timeout, unit)而非take()，或Thread.sleep()并捕获InterruptedException - 避免在
catch(InterruptedException)后简单吞掉异常而不恢复中断状态（应调用Thread.currentThread().interrupt()）
完整示例（生产可用模板）
以下是一个典型的关闭逻辑，兼顾可读性与健壮性：
executor.shutdown();
try {
if (!executor.awaitTermination(60, TimeUnit.SECONDS)) {
executor.shutdownNow();
if (!executor.awaitTermination(10, TimeUnit.SECONDS)) {
System.err.println("线程池未能在规定时间内关闭");
}
}
} catch (InterruptedException e) {
executor.shutdownNow();
Thread.currentThread().interrupt();
}
这段代码做了三件事：先等 60 秒让任务自然结束；超时后尝试强制中断；再给 10 秒确认是否真的关掉了；最后处理中断异常并恢复中断标记。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
