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。