Spring Boot 2.3.0 如何優(yōu)雅停機(jī)

@RestController
public class DemoController {
 @GetMapping("/demo")
 public String demo() throws InterruptedException {
     // 模擬業(yè)務(wù)耗時(shí)處理流程
  Thread.sleep(20 * 1000L);
  return "hello";
 }
}

當(dāng)我們流量請求到此接口執(zhí)行業(yè)務(wù)邏輯的時(shí)候，若服務(wù)端此時(shí)執(zhí)行關(guān)機(jī) （kill），spring boot 默認(rèn)情況會直接關(guān)閉容器（tomcat 等），導(dǎo)致此業(yè)務(wù)邏輯執(zhí)行失敗。在一些業(yè)務(wù)場景下：會出現(xiàn)數(shù)據(jù)不一致的情況，事務(wù)邏輯不會回滾。

graceful shutdown

在最新的 spring boot 2.3 版本，內(nèi)置此功能，不需要再自行擴(kuò)展容器線程池來處理， 目前 spring boot 嵌入式支持的 web 服務(wù)器（Jetty、Reactor Netty、Tomcat 和 Undertow）以及反應(yīng)式和基于 Servlet 的 web 應(yīng)用程序都支持優(yōu)雅停機(jī)功能。

我們來看下如何使用:

當(dāng)使用server.shutdown=graceful啟用時(shí)，在 web 容器關(guān)閉時(shí)，web 服務(wù)器將不再接收新請求，并將等待活動請求完成的緩沖期。

配置體驗(yàn)

此處支持的 shutdown 行為，我們看下 源碼枚舉如下：

/**
 * Configuration for shutting down a {@link WebServer}.
 *
 * @author Andy Wilkinson
 * @since 2.3.0
 */
public enum Shutdown {
 /**
  * 優(yōu)雅停機(jī) （限期停機(jī)）
  *
  */
 GRACEFUL,

 /**
  * 立即停機(jī)
  */
 IMMEDIATE;

}

緩沖期 timeout-per-shutdown-phase 配置

默認(rèn)時(shí)間為 30S, 意味著最大等待 30S，超時(shí)候無論線程任務(wù)是否執(zhí)行完畢都會停機(jī)處理，一定要合理合理設(shè)置。

效果體驗(yàn)

1、請求服務(wù)端接口

2、執(zhí)行關(guān)閉應(yīng)用

3、服務(wù)端接到關(guān)閉指令

2020-05-17 18:28:28.940  INFO 60341 --- [extShutdownHook] o.s.b.w.e.tomcat.GracefulShutdown        : Commencing graceful shutdown. Waiting for active requests to complete
2020-05-17 18:28:45.923  INFO 60341 --- [tomcat-shutdown] o.s.b.w.e.tomcat.GracefulShutdown        : Graceful shutdown complete

相關(guān)知識

1. 關(guān)于此處執(zhí)行      kill -2 而不是      kill -9

kill -2 相當(dāng)于快捷鍵 Ctrl + C 會觸發(fā) Java 的 ShutdownHook 事件處理（優(yōu)雅停機(jī)或者一些后置處理可參考以下源碼）

//ApplicationContext
 @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);
  }
 }

kill -9，暴力美學(xué)強(qiáng)制殺死進(jìn)程，不會執(zhí)行 ShutdownHook

2. 通過 actuate 端點(diǎn)實(shí)現(xiàn)優(yōu)雅停機(jī)

POST 請求 /actuator/shutdown 即可執(zhí)行優(yōu)雅關(guān)機(jī)。

源碼解析

@Endpoint(id = "shutdown", enableByDefault = false)
public class ShutdownEndpoint implements ApplicationContextAware {

 @WriteOperation
 public Map<String, String> 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();
 }
}

3. 不同 web 容器優(yōu)雅停機(jī)行為區(qū)別
   
      

容器停機(jī)行為取決于具體的 web 容器行為