优雅关闭

所有四个嵌入式 Web 服务器（Jetty、Reactor Netty、Tomcat 和 Undertow）以及响应式和基于 Servlet 的 Web 应用程序都支持优雅关闭。它作为关闭应用程序上下文的一部分发生，并在停止 SmartLifecycle bean 的最早阶段执行。此停止处理使用超时，该超时提供一个宽限期，在此期间允许现有请求完成，但不再允许新的请求。

不允许新的请求的确切方式取决于正在使用的 Web 服务器。实现可能会在网络层停止接受请求，或者它们可能会返回带有特定 HTTP 状态代码或 HTTP 标头的响应。持久连接的使用也会改变请求停止接受的方式。

要了解有关 Web 服务器使用的特定方法的更多信息，请参阅 TomcatWebServer、NettyWebServer、JettyWebServer 或 UndertowWebServer 的 shutDownGracefully javadoc。

Jetty、Reactor Netty 和 Tomcat 将在网络层停止接受新的请求。Undertow 将接受新的连接，但会立即以服务不可用 (503) 响应进行响应。

Tomcat 的优雅关闭需要 Tomcat 9.0.33 或更高版本。

要启用优雅关闭，请配置 server.shutdown 属性，如下例所示

  • 属性

  • YAML

server.shutdown=graceful
server:
  shutdown: "graceful"

要配置超时时间段，请配置 spring.lifecycle.timeout-per-shutdown-phase 属性，如下例所示

  • 属性

  • YAML

spring.lifecycle.timeout-per-shutdown-phase=20s
spring:
  lifecycle:
    timeout-per-shutdown-phase: "20s"
如果您的 IDE 未发送正确的 SIGTERM 信号，则使用您的 IDE 进行优雅关闭可能无法正常工作。有关更多详细信息，请参阅您的 IDE 文档。