一文带你掌握springBoot如何做到优雅停机的

 更新时间:2025年04月08日 09:41:04   作者:雷渊  
在分布式系统中,服务的优雅停机(Graceful Shutdown)是确保业务连续性的重要机制,下面就跟随小编一起来深入了解下springBoot实现优雅停机的具体方式吧

在分布式系统中,服务的优雅停机(Graceful Shutdown)是确保业务连续性的重要机制。Spring Boot 通过 内嵌服务器支持生命周期管理 实现了这一功能,以下是具体实现方式和配置细节:

1. 优雅停机的核心目标

  • 停止接收新请求:关闭监听端口,不再接受新连接。
  • 等待处理中的请求完成:允许正在执行的请求继续处理直至超时。
  • 释放资源:关闭数据库连接池、线程池等资源。
  • 避免数据不一致:确保事务完整性,防止中途中断。

2. 基于内嵌服务器的优雅停机配置

Spring Boot 从 2.3 版本 开始,为 Tomcat、Jetty、Undertow 等内嵌服务器内置了优雅停机支持。

2.1 启用优雅停机

application.propertiesapplication.yml 中配置:

server:
  shutdown: graceful  # 启用优雅停机模式
spring:
  lifecycle:
    timeout-per-shutdown-phase: 30s  # 等待请求完成的超时时间(默认30秒)

2.2 不同服务器的行为

服务器优雅停机行为
Tomcat停止接收新请求,等待处理中的请求完成,超时后强制关闭。
Jetty停止接收新连接,等待活跃请求完成。
Undertow关闭监听端口,等待活跃请求完成。

2.3 验证停机流程

1.发送停机信号

通过 SIGTERM 信号(Kill 命令)或 Actuator 端点关闭应用。

使用 Actuator 端点需要添加依赖和配置:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
management:
  endpoint:
    shutdown:
      enabled: true
  endpoints:
    web:
      exposure:
        include: shutdown

发送 POST 请求关闭应用:

curl -X POST http://localhost:8080/actuator/shutdown

2.观察日志

2023-10-05 14:20:00 INFO  o.s.b.w.e.tomcat.GracefulShutdown : Commencing graceful shutdown. Waiting for active requests to complete
2023-10-05 14:20:30 INFO  o.s.b.w.e.tomcat.GracefulShutdown : Graceful shutdown complete

3. 自定义停机逻辑扩展

3.1 监听停机事件

通过实现 ApplicationListener<ContextClosedEvent> 监听上下文关闭事件:

@Component
public class GracefulShutdownListener implements ApplicationListener<ContextClosedEvent> {
    @Override
    public void onApplicationEvent(ContextClosedEvent event) {
        //dubbo关闭
        DubboBootstrap.getInstance().stop();
        // 执行自定义清理逻辑(如关闭线程池、释放资源)
        ExecutorService executor = event.getApplicationContext().getBean(ExecutorService.class);
        executor.shutdown();
        try {
            if (!executor.awaitTermination(30, TimeUnit.SECONDS)) {
                executor.shutdownNow();
            }
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt();
        }
    }
}

3.2 使用 @PreDestroy 注解

在 Bean 销毁前执行清理逻辑:

@Service
public class DatabaseService {
    @PreDestroy
    public void cleanup() {
        // 关闭数据库连接
        DataSource dataSource = ...;
        dataSource.close();
    }
}

4. 集成 Kubernetes 的优雅停机

在 Kubernetes 中,结合 Pod 生命周期钩子 实现优雅停机:

4.1 配置 PreStop Hook

在 Deployment 配置中添加 preStop 钩子,延迟终止进程:

spec:
  template:
    spec:
      containers:
        - name: app
          lifecycle:
            preStop:
              exec:
                command: ["sh", "-c", "sleep 30"]  # 等待30秒后发送SIGTERM
          terminationGracePeriodSeconds: 60  # 总宽限期(包括preStop)

4.2 配合就绪探针

在停机前标记服务不可用:

readinessProbe:
  httpGet:
    path: /actuator/health/readiness
    port: 8080

5. 常见问题与解决方案

问题解决方案
停机超时后仍有未完成请求调整 spring.lifecycle.timeout-per-shutdown-phase 延长等待时间。
线程池任务未执行完自定义 ExecutorService 并在停机时调用 shutdown() 和 awaitTermination()。
数据库连接未关闭通过 @PreDestroy 或 DisposableBean 显式关闭连接池。
Kubernetes 强制终止 Pod确保 terminationGracePeriodSeconds 大于优雅停机超时时间。

6. 验证优雅停机效果

1.发送长耗时请求

curl http://localhost:8080/long-task

2.触发停机

curl -X POST http://localhost:8080/actuator/shutdown

3.观察结果

  • 新请求返回 503 Service Unavailable
  • 正在处理的请求继续执行直至完成或超时。

总结

通过 内嵌服务器配置生命周期钩子Kubernetes 集成,Spring Boot 实现了开箱即用的优雅停机功能。关键配置包括:

  • 启用 server.shutdown=graceful。
  • 设置合理的超时时间。
  • 结合 Actuator 端点或 Kubernetes 生命周期管理。

到此这篇关于一文带你掌握springBoot如何做到优雅停机的的文章就介绍到这了,更多相关springBoot停机内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java设计模式中的适配器模式

    Java设计模式中的适配器模式

    这篇文章主要介绍了Java设计模式中的适配器模式,适配器模式(Adapter Pattern)将某个类的接口转换成客户端期望的另一个接口表示,主的目的是兼容性,让原本因接口不匹配不能一起工作的两个类可以协同工作。其别名为包装器
    2022-07-07
  • mybatis中使用大于小于等于的正确方法

    mybatis中使用大于小于等于的正确方法

    在mybatis中sql是写在xml映射文件中的,如果sql中有一些特殊字符的话,在解析xml文件的时候就会被转义,下面我们就一起来看一下大于小于等于是怎么转义的
    2021-04-04
  • SpringBoot中@Autowired注入service时出现循环依赖问题的解决方法

    SpringBoot中@Autowired注入service时出现循环依赖问题的解决方法

    在Spring Boot开发过程中,@Autowired注入Service时出现循环依赖是一个常见问题,循环依赖指的是两个或多个Bean相互依赖,形成闭环,导致Spring容器无法正常初始化这些Bean,这里提供几种解决Spring Boot中@Autowired注入Service时循环依赖问题的方法
    2024-02-02
  • springboot 中 druid+jpa+MYSQL数据库配置过程

    springboot 中 druid+jpa+MYSQL数据库配置过程

    这篇文章主要介绍了springboot 中 druid+jpa+MYSQL数据库配置,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-08-08
  • mybatis-plus 如何使用雪花算法ID生成策略

    mybatis-plus 如何使用雪花算法ID生成策略

    这篇文章主要介绍了mybatis-plus如何使用雪花算法ID生成策略,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-12-12
  • Java经典排序算法之插入排序

    Java经典排序算法之插入排序

    这篇文章主要为大家详细介绍了Java经典排序算法之插入排序,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-04-04
  • SpringBoot3集成Quartz的示例代码

    SpringBoot3集成Quartz的示例代码

    Quartz由Java编写的功能丰富的开源作业调度框架,可以集成到几乎任何Java应用程序中,并且能够创建多个作业调度,在实际的业务中,有很多场景依赖定时任务,比如常见的:订单超时处理,业务识别和预警通知等,本文介绍了SpringBoot3如何集成Quartz
    2023-08-08
  • 如何在JDK 9中更简洁使用 try-with-resources 语句

    如何在JDK 9中更简洁使用 try-with-resources 语句

    本文详细介绍了自 JDK 7 引入的 try-with-resources 语句的原理和用法,以及介绍了 JDK 9 对 try-with-resources 的改进,使得用户可以更加方便、简洁的使用 try-with-resources 语句。,需要的朋友可以参考下
    2019-06-06
  • springmvc限流拦截器的示例代码

    springmvc限流拦截器的示例代码

    本篇文章主要介绍了springmvc限流拦截器的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-12-12
  • Jenkin邮件收发实现原理及过程详解

    Jenkin邮件收发实现原理及过程详解

    这篇文章主要介绍了Jenkin邮件收发实现原理及过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-09-09

最新评论