java

关注公众号 jb51net

关闭
首页 > 软件编程 > java > SpringBoot停机

从原理到最佳实践详解SpringBoot如何实现优雅停机

作者：程序员1970

优雅停机在现代微服务架构中是非常重要的,它帮助我们确保在应用程序停止时,不会中断正在进行的请求或导致数据丢失,下面我们就来看看SpringBoot实现优雅停机的具体方法吧

微服务和云原生时代，应用的平滑启停是保障系统高可用的关键环节。Spring Boot 在 2.3 版本引入了对内嵌 Web 容器优雅停机的原生支持，改变此前需要手动编码实现局面。

一、什么是“优雅停机”

优雅停机（Graceful Shutdown） 是指在应用停止过程中：

若未实现优雅停机，在滚动更新、缩容或重启时，极易出现如下典型异常：

ERROR ... - Error creating bean with name 'orderController': 
Singleton bean creation not allowed while singletons of this factory are in destruction
org.springframework.beans.factory.BeanCreationNotAllowedException: ...

异常表明：Spring 容器正在销毁，但仍有请求试图获取 Controller Bean —— 这正是停机流程设计不当的直接体现。

二、核心组件与层级关系

要理解停机流程，需先厘清以下组件的包含关系：

JVM
 └── 内嵌 Web 容器（如 Tomcat）
      └── Servlet 容器（StandardContext）
           └── DispatcherServlet（Spring MVC 入口）
                └── Spring ApplicationContext（IoC 容器）
                     └── 所有 Spring Bean（@Controller, @Service 等）

关键点：Spring 容器运行在 Web 容器内部。停机时，必须协调二者关闭顺序，否则就会出现“Web 容器还在处理请求，但 Spring 容器已拒绝服务”的竞态条件。

三、Spring Boot < 2.3：手动实现的“伪优雅”

在2.3之前，Spring Boot 没有内置优雅停机能力。默认行为是：

问题本质：关闭顺序错误

先关 Spring，再关 Web 容器 → 存在危险时间窗口。

开发者workaround

需手动实现以下逻辑：

@Component
public class GracefulShutdown implements TomcatConnectorCustomizer, 
                                      ApplicationListener<ContextClosedEvent> {

    private volatile Connector connector;

    @Override
    public void customize(Connector connector) {
        this.connector = connector;
    }

    @Override
    public void onApplicationEvent(ContextClosedEvent event) {
        connector.pause(); // 停止接收新请求
        
        Executor executor = connector.getProtocolHandler().getExecutor();
        if (executor instanceof ThreadPoolExecutor) {
            try {
                ((ThreadPoolExecutor) executor).shutdown();
                ((ThreadPoolExecutor) executor).awaitTermination(30, TimeUnit.SECONDS);
            } catch (InterruptedException e) {
                Thread.currentThread().interrupt();
            }
        }
    }
}

同时需注册到 Tomcat：

@Bean
public ServletWebServerFactory servletContainer() {
    TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory();
    tomcat.addConnectorCustomizers(gracefulShutdown());
    return tomcat;
}

即便如此，仍无法完美处理 HTTP/1.1 keep-alive 连接复用带来的新请求。

四、Spring Boot ≥ 2.3：原生优雅停机

Spring Boot 2.3 引入了 标准化的优雅停机机制，通过两行配置即可启用：

server:
  shutdown: graceful          # 启用优雅停机
spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s  # 等待超时时间

核心思想：反转关闭顺序 + 流量控制前置

停机流程变为：

底层原理

1.SmartLifecycle控制关闭阶段

Spring Boot 注册了 WebServerGracefulShutdownLifecycle，它实现 SmartLifecycle 接口，并设置：

@Override
public int getPhase() {
    return Integer.MAX_VALUE; // 最后启动，最先停止
}

确保其 stop() 方法在普通 Bean 销毁之前执行。

2.WebServer 接口标准化

不同内嵌服务器实现统一的 GracefulShutdown 行为：

3.与 Spring 生命周期深度集成

通过 LifecycleProcessor 协调所有 SmartLifecycle Bean 的关闭顺序，确保 Web 容器优雅关闭完成之后，才触发 ApplicationContext.close()。

五、2.3 前后对比总表

维度Spring Boot < 2.3Spring Boot ≥ 2.3
是否内置支持需手动编码开箱即用
关闭起点Spring 容器Web 容器
新请求处理继续 accept → 高风险立即拒绝（pause/503）→ 安全
已进入请求可能因 Spring 关闭而失败等待完成（最多 timeout）
典型异常BeanCreationNotAllowedException 高频极少（除非超时）
配置复杂度高（需自定义监听器）低（仅需 YAML）
多容器支持仅限手动适配自动支持 Tomcat/Jetty/Undertow/Netty
K8s 友好度差优秀

六、生产环境最佳实践

1.启用优雅停机（2.3+）

server:
  shutdown: graceful
spring:
  lifecycle:
    timeout-per-shutdown-phase: 45s  # > 业务最大请求耗时

2.Kubernetes 部署配合 preStop

spec:
  containers:
    - name: app
      lifecycle:
        preStop:
          exec:
            command: ["sleep", "15"]  # 给 LB 时间摘除节点
      terminationGracePeriodSeconds: 60

3.Windows 服务需走 Actuator

management:
  endpoint:
    shutdown:
      enabled: true
  endpoints:
    web:
      exposure:
        include: "shutdown"

并通过外部命令触发：

curl -X POST http://localhost:8080/actuator/shutdown

4.监控与告警

到此这篇关于从原理到最佳实践详解SpringBoot如何实现优雅停机的文章就介绍到这了,更多相关SpringBoot停机内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文