Java 后端 / 系统课时
实现优雅停机
实现优雅停机
本课解决应用发布、重启或扩容时请求中断和任务丢失的问题。你将配置 Spring Boot 优雅关闭流程,让服务先停止接收新请求,再安全处理已有任务。
学习目标
- 理解应用关闭过程中请求、线程和资源的生命周期。
- 配置 Spring Boot 优雅停机机制并验证效果。
- 掌握就绪状态切换和后台任务停止顺序。
优雅停机解决什么问题
直接终止进程会立即关闭连接,正在处理的请求可能返回错误,消息消费或异步任务也可能被截断。
优雅停机的核心流程是:先从流量入口摘除实例,再等待已有请求完成,最后释放线程池、数据库连接等资源。

配置 Spring Boot 优雅关闭
Spring Boot 3 默认支持优雅关闭,可以通过配置开启停机等待行为:
yaml
server:
shutdown: graceful
spring:
lifecycle:
timeout-per-shutdown-phase: 30stimeout-per-shutdown-phase 表示每个关闭阶段最多等待时间。实际值应根据接口耗时和业务需求调整。验证配置可以启动应用后发送请求,再触发关闭操作:
bash
kill -TERM <PID>预期输出
text
Application shutdown initiated
Waiting for active requests to complete
Application shutdown completed控制任务停止顺序
生产应用通常包含 HTTP 请求、消息消费、定时任务和异步线程。关闭时应避免新任务继续进入。推荐顺序如下:
- 停止接收新流量。
- 停止拉取新的消息或任务。
- 等待正在执行的任务完成。
- 关闭外部连接和资源。
例如消息消费者需要在关闭阶段暂停消费,而不是直接退出消费者线程。
与健康检查和负载均衡结合
在容器平台中,优雅停机不仅是应用内部行为,还需要配合就绪探针。实例进入 Not Ready 后,负载均衡器会停止发送新请求。
如果只配置应用关闭,而没有正确处理流量摘除,仍可能出现关闭过程中新增请求进入的问题。
常见失败处理
如果停机期间请求仍然失败,可以按以下顺序检查:
- 检查负载均衡是否支持实例摘除等待。
- 检查关闭等待时间是否覆盖最长请求耗时。
- 检查后台线程是否阻塞导致无法退出。
- 检查消息消费是否存在未确认任务。
按自己的节奏,确认真正理解。