Spring Boot 优雅停机

▶ Spring Boot 依赖与配置

Maven 依赖

        
            org.springframework.boot
            spring-boot-starter-actuator
        

        
            com.github.timpeeters
            spring-boot-graceful-shutdown
            2.1.1
        

▶ Graceful Shutdown 配置说明

配置项	默认值	描述
graceful.shutdown.enabled	false	是否启用优雅停机
graceful.shutdown.timeout	60	在关闭 Tomcat Connector 之前等待活跃线程完成的秒数
graceful.shutdown.wait	30	优雅停机前，服务处于 OUT_OF_SERVICE 的时间

▶ Graceful Shutdown 流程

1. JVM 接受 SIGTERM 信号，开始关闭 Spring Container
2. Spring EventListener 监听 ContextClosedEvent 事件，关闭开始后回调
3. EventListener 更新 Spring Boot HealthIndicator 为 "OUT_OF_SERVICE"
4. 使用 Thread.sleep 延迟 Context 关闭，以便负载均衡器查看更新的 HealthIndicator 状态，并停止向此实例转发请求
5. 当 Thread.sleep 结束, Tomcat container 正常关闭。首先通过暂停 Connector，不再接受新的请求，然后通过配置的时间让 Tomcat 线程池处理活跃的线程
6. 最后, Spring Context 关闭

▶ Github Demo URL

• https://github.com/ChinaSilence/spring-boot-demos/tree/master/03%20-%20graceful%20shutdown

示例中，Spring Boot 配置如下：

graceful.shutdown.enabled=true
graceful.shutdown.timeout=60s
graceful.shutdown.wait=30s

正常运行时，执行 curl http://127.0.0.1:8080/actuator/health，结果如下：

{
    "status": "UP"
}

关闭服务后，30 秒内，执行 curl http://127.0.0.1:8080/actuator/health，结果如下：

{
    "status": "OUT_OF_SERVICE"
}

30 秒内，服务能正常接收新的请求。30 秒后，服务不再接受新的请求，会有如下几种情况：

• Tomcat 无请求待处理，服务立即关闭
• Tomcat 有请求待处理，处理时间在 60 秒内，服务会在所有请求处理完后立即关闭
• Tomcat 有请求待处理，处理时间超过 60 秒，服务会在 60 秒后强制关闭，异常退出