Graceful Shutdown (Graceful Shutdown) _ Spring Boot3.4.0-SNAPSHOT中文文档(官方文档中文翻译)|Spring 教程 —

This version is still in development and is not considered stable yet. For the latest stable version, please use Spring Boot 3.3.4!spring-doc.cn

Graceful shutdown is enabled by default with all four embedded web servers (Jetty, Reactor Netty, Tomcat, and Undertow) and with both reactive and servlet-based web applications. It occurs as part of closing the application context and is performed in the earliest phase of stopping SmartLifecycle beans. This stop processing uses a timeout which provides a grace period during which existing requests will be allowed to complete but no new requests will be permitted.spring-doc.cn

To configure the timeout period, configure the spring.lifecycle.timeout-per-shutdown-phase property, as shown in the following example:spring-doc.cn

Propertiesspring-doc.cn
YAMLspring-doc.cn

spring.lifecycle.timeout-per-shutdown-phase=20s

spring:
  lifecycle:
    timeout-per-shutdown-phase: "20s"

Shutdown in your IDE may be immediate rather than graceful if it does not send a proper SIGTERM signal. See the documentation of your IDE for more details.

Rejecting Requests During the Grace Period

The exact way in which new requests are not permitted varies depending on the web server that is being used. Implementations may stop accepting requests at the network layer, or they may return a response with a specific HTTP status code or HTTP header. The use of persistent connections can also change the way that requests stop being accepted.spring-doc.cn

To learn more about the specific method used with your web server, see the shutDownGracefully API documentation for TomcatWebServer.shutDownGracefully(GracefulShutdownCallback), NettyWebServer.shutDownGracefully(GracefulShutdownCallback), JettyWebServer.shutDownGracefully(GracefulShutdownCallback) or UndertowWebServer.shutDownGracefully(GracefulShutdownCallback).

Jetty, Reactor Netty, and Tomcat will stop accepting new requests at the network layer. Undertow will accept new connections but respond immediately with a service unavailable (503) response.spring-doc.cn

Disabling Graceful Shutdown

To disable graceful shutdown, configure the server.shutdown property, as shown in the following example:spring-doc.cn

Propertiesspring-doc.cn
YAMLspring-doc.cn

server.shutdown=immediate

server:
  shutdown: "immediate"