Java 后端 / 系统课时

实现优雅停机

实现优雅停机

本课解决应用发布、重启或扩容时请求中断和任务丢失的问题。你将配置 Spring Boot 优雅关闭流程,让服务先停止接收新请求,再安全处理已有任务。

学习目标

  • 理解应用关闭过程中请求、线程和资源的生命周期。
  • 配置 Spring Boot 优雅停机机制并验证效果。
  • 掌握就绪状态切换和后台任务停止顺序。

优雅停机解决什么问题

直接终止进程会立即关闭连接,正在处理的请求可能返回错误,消息消费或异步任务也可能被截断。

优雅停机的核心流程是:先从流量入口摘除实例,再等待已有请求完成,最后释放线程池、数据库连接等资源。

Spring Boot 优雅停机生命周期流程图

配置 Spring Boot 优雅关闭

Spring Boot 3 默认支持优雅关闭,可以通过配置开启停机等待行为:

yaml
server:
  shutdown: graceful

spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s

timeout-per-shutdown-phase 表示每个关闭阶段最多等待时间。实际值应根据接口耗时和业务需求调整。验证配置可以启动应用后发送请求,再触发关闭操作:

bash
kill -TERM <PID>

预期输出

text
Application shutdown initiated
Waiting for active requests to complete
Application shutdown completed

控制任务停止顺序

生产应用通常包含 HTTP 请求、消息消费、定时任务和异步线程。关闭时应避免新任务继续进入。推荐顺序如下:

  1. 停止接收新流量。
  2. 停止拉取新的消息或任务。
  3. 等待正在执行的任务完成。
  4. 关闭外部连接和资源。

例如消息消费者需要在关闭阶段暂停消费,而不是直接退出消费者线程。

与健康检查和负载均衡结合

在容器平台中,优雅停机不仅是应用内部行为,还需要配合就绪探针。实例进入 Not Ready 后,负载均衡器会停止发送新请求。

如果只配置应用关闭,而没有正确处理流量摘除,仍可能出现关闭过程中新增请求进入的问题。

常见失败处理

如果停机期间请求仍然失败,可以按以下顺序检查:

  • 检查负载均衡是否支持实例摘除等待。
  • 检查关闭等待时间是否覆盖最长请求耗时。
  • 检查后台线程是否阻塞导致无法退出。
  • 检查消息消费是否存在未确认任务。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现优雅停机

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通