对于最新的稳定版本,请使用 Spring Boot 3.5.5spring-doc.cadn.net.cn

优雅关机

默认情况下,所有四个嵌入式 Web 服务器(Jetty、Reactor Netty、Tomcat 和 Undertow)以及响应式和基于 servlet 的 Web 应用程序都启用了正常关机。 它作为关闭应用程序上下文的一部分发生,并在停止的最早阶段执行SmartLifecycle豆。 此停止处理使用超时,该超时提供宽限期,在此期间将允许完成现有请求,但不允许新请求。spring-doc.cadn.net.cn

要配置超时期限,请配置spring.lifecycle.timeout-per-shutdown-phase属性,如以下示例所示:spring-doc.cadn.net.cn

spring.lifecycle.timeout-per-shutdown-phase=20s
spring:
  lifecycle:
    timeout-per-shutdown-phase: "20s"
如果 IDE 没有发送适当的SIGTERM信号。 有关更多详细信息,请参阅 IDE 的文档。

在宽限期内拒绝请求

不允许新请求的确切方式因所使用的 Web 服务器而异。 实现可能会停止接受网络层的请求,或者它们可能会返回带有特定 HTTP 状态代码或 HTTP 标头的响应。 使用持久连接还可以更改停止接受请求的方式。spring-doc.cadn.net.cn

Jetty、Reactor Netty 和 Tomcat 将停止在网络层接受新请求。 Undertow 将接受新的连接,但会立即响应服务不可用 (503) 响应。spring-doc.cadn.net.cn

禁用正常关机

要禁用正常关机,请配置server.shutdown属性,如以下示例所示:spring-doc.cadn.net.cn

server.shutdown=immediate
server:
  shutdown: "immediate"