导航：首页 > 开发技术 >

SpringBoot如何进行优雅停服

发表于：2025-01-17 作者：千家信息网编辑

千家信息网最后更新 2025年01月17日，SpringBoot如何进行优雅停服，相信很多没有经验的人对此束手无策，为此本文总结了问题出现的原因和解决方法，通过这篇文章希望你能解决这个问题。一、介绍当外部流量请求到服务端接口执行业务逻辑的时候，

千家信息网最后更新 2025年01月17日SpringBoot如何进行优雅停服

SpringBoot如何进行优雅停服，相信很多没有经验的人对此束手无策，为此本文总结了问题出现的原因和解决方法，通过这篇文章希望你能解决这个问题。

一、介绍

当外部流量请求到服务端接口执行业务逻辑的时候，若服务端此时执行关机（kill），spring boot 默认情况会直接关闭容器（tomcat 等），导致此业务逻辑执行失败。在一些业务场景下：会出现数据不一致的情况，事务逻辑不会回滚。

在最新的 spring boot 2.3 版本，内置此功能，不需要再自行扩展容器线程池来处理，目前 spring boot 嵌入式支持的 web 服务器（Jetty、Reactor Netty、Tomcat 和 Undertow）以及反应式和基于 Servlet 的 web 应用程序都支持优雅停机功能。

此处支持的 shutdown 行为，我们看下源码枚举如下：

public enum Shutdown { /**  * 优雅停机 （限期停机）  *  */ GRACEFUL, /**  * 立即停机  */ IMMEDIATE;}

二、使用

当使用server.shutdown=graceful启用时，在 web 容器关闭时，web 服务器将不再接收新请求，并将等待活动请求完成的缓冲期。

缓冲期 timeout-per-shutdown-phase 配置：默认时间为 30S, 意味着最大等待 30S，超时候无论线程任务是否执行完毕都会停机处理，一定要根据项目实际需要合理设置。

以上配置完毕，重新发布以后，服务端就支持优雅停服。

三、触发优雅停服

1、对进城PID执行kill -2 而不是 kill -9

kill -9，暴力美学强制杀死进程，不会执行 ShutdownHook；但是 kill -2 相当于快捷键 Ctrl + C 会触发 Java 的 ShutdownHook 事件处理进行优雅停机或者一些后置处理。可参考以下源码：

  @Override public void registerShutdownHook() {  if (this.shutdownHook == null) {   // No shutdown hook registered yet.   this.shutdownHook = new Thread(SHUTDOWN_HOOK_THREAD_NAME) {    @Override    public void run() {     synchronized (startupShutdownMonitor) {      doClose();     }    }   };   Runtime.getRuntime().addShutdownHook(this.shutdownHook);  } }

2、通过 actuate 端点实现优雅停机

POST 请求 /actuator/shutdown 即可执行优雅关机。源码解析如下：

@Endpoint(id = "shutdown", enableByDefault = false)public class ShutdownEndpoint implements ApplicationContextAware { @WriteOperation public Map shutdown() {  Thread thread = new Thread(this::performShutdown);  thread.setContextClassLoader(getClass().getClassLoader());  thread.start(); } private void performShutdown() {  try {   Thread.sleep(500L);  }  catch (InterruptedException ex) {   Thread.currentThread().interrupt();  }  // 此处close 逻辑和上边 shutdownhook 的处理一样  this.context.close(); }}