Spring Boot 2.3 新特性優雅停機詳解

本文爲原創文章。歡迎任何形式的轉載，但請務必註明出處 冷冷https://lltx.github.io。

什麼是優雅停機

先來一段簡單的代碼，以下：

@RestController
public class DemoController {
	@GetMapping("/demo")
	public String demo() throws InterruptedException {
	    // 模擬業務耗時處理流程
		Thread.sleep(20 * 1000L);
		return "hello";
	}
}
複製代碼

當咱們流量請求到此接口執行業務邏輯的時候，若服務端此時執行關機 （kill），spring boot 默認狀況會直接關閉容器（tomcat 等），致使此業務邏輯執行失敗。在一些業務場景下：會出現數據不一致的狀況，事務邏輯不會回滾。

graceful shutdown

在最新的 spring boot 2.3 版本，內置此功能，不須要再自行擴展容器線程池來處理， 目前 spring boot 嵌入式支持的 web 服務器（Jetty、Reactor Netty、Tomcat 和 Undertow）以及反應式和基於 Servlet 的 web 應用程序都支持優雅停機功能。 咱們來看下如何使用:

當使用server.shutdown=graceful啓用時，在 web 容器關閉時，web 服務器將再也不接收新請求，並將等待活動請求完成的緩衝期。

配置體驗

此處支持的 shutdown 行爲，咱們看下 源碼枚舉以下：

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

	/**
	 * 當即停機
	 */
	IMMEDIATE;

}
複製代碼

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

• 默認時間爲 30S, 意味着最大等待 30S，超時候不管線程任務是否執行完畢都會停機處理，必定要合理合理設置。

效果體驗

• 1. 請求服務端接口

• 2. 執行關閉應用

• 3. 服務端接到關閉指令

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
複製代碼

• 4. 接口請求執行完成

相關知識

1. 關於此處執行kill -2 而不是 kill -9

• kill -2 至關於快捷鍵 Ctrl + C 會觸發 Java 的 ShutdownHook 事件處理（優雅停機或者一些後置處理可參考如下源碼）

//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，暴力美學強制殺死進程，不會執行 ShutdownHook

2. 經過 actuate 端點實現優雅停機

POST 請求 /actuator/shutdown 便可執行優雅關機。

源碼解析

@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 容器優雅停機行爲區別

容器停機行爲取決於具體的 web 容器行爲

web 容器名稱	行爲說明
tomcat 9.0.33+	中止接收請求，客戶端新請求等待超時。
Reactor Netty	中止接收請求，客戶端新請求等待超時。
Undertow	中止接收請求，客戶端新請求直接返回 503。