一文帶你掌握springBoot如何做到優(yōu)雅停機的
在分布式系統(tǒng)中，服務(wù)的優(yōu)雅停機（Graceful Shutdown）是確保業(yè)務(wù)連續(xù)性的重要機制。Spring Boot 通過 內(nèi)嵌服務(wù)器支持 和 生命周期管理 實現(xiàn)了這一功能，以下是具體實現(xiàn)方式和配置細(xì)節(jié)：
1. 優(yōu)雅停機的核心目標(biāo)
- 停止接收新請求：關(guān)閉監(jiān)聽端口，不再接受新連接。
- 等待處理中的請求完成：允許正在執(zhí)行的請求繼續(xù)處理直至超時。
- 釋放資源：關(guān)閉數(shù)據(jù)庫連接池、線程池等資源。
- 避免數(shù)據(jù)不一致：確保事務(wù)完整性，防止中途中斷。
2. 基于內(nèi)嵌服務(wù)器的優(yōu)雅停機配置
Spring Boot 從 2.3 版本 開始，為 Tomcat、Jetty、Undertow 等內(nèi)嵌服務(wù)器內(nèi)置了優(yōu)雅停機支持。
2.1 啟用優(yōu)雅停機
在 application.properties 或 application.yml 中配置：
server:
shutdown: graceful # 啟用優(yōu)雅停機模式
spring:
lifecycle:
timeout-per-shutdown-phase: 30s # 等待請求完成的超時時間（默認(rèn)30秒）
2.2 不同服務(wù)器的行為
| 服務(wù)器 | 優(yōu)雅停機行為 |
|---|---|
| Tomcat | 停止接收新請求，等待處理中的請求完成，超時后強制關(guān)閉。 |
| Jetty | 停止接收新連接，等待活躍請求完成。 |
| Undertow | 關(guān)閉監(jiān)聽端口，等待活躍請求完成。 |
2.3 驗證停機流程
1.發(fā)送停機信號：
通過 SIGTERM 信號（Kill 命令）或 Actuator 端點關(guān)閉應(yīng)用。
使用 Actuator 端點需要添加依賴和配置：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
management:
endpoint:
shutdown:
enabled: true
endpoints:
web:
exposure:
include: shutdown
發(fā)送 POST 請求關(guān)閉應(yīng)用：
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 監(jiān)聽停機事件
通過實現(xiàn) ApplicationListener<ContextClosedEvent> 監(jiān)聽上下文關(guān)閉事件：
@Component
public class GracefulShutdownListener implements ApplicationListener<ContextClosedEvent> {
@Override
public void onApplicationEvent(ContextClosedEvent event) {
//dubbo關(guān)閉
DubboBootstrap.getInstance().stop();
// 執(zhí)行自定義清理邏輯（如關(guān)閉線程池、釋放資源）
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 銷毀前執(zhí)行清理邏輯：
@Service
public class DatabaseService {
@PreDestroy
public void cleanup() {
// 關(guān)閉數(shù)據(jù)庫連接
DataSource dataSource = ...;
dataSource.close();
}
}
4. 集成 Kubernetes 的優(yōu)雅停機
在 Kubernetes 中，結(jié)合 Pod 生命周期鉤子 實現(xiàn)優(yōu)雅停機：
4.1 配置 PreStop Hook
在 Deployment 配置中添加 preStop 鉤子，延遲終止進(jìn)程：
spec:
template:
spec:
containers:
- name: app
lifecycle:
preStop:
exec:
command: ["sh", "-c", "sleep 30"] # 等待30秒后發(fā)送SIGTERM
terminationGracePeriodSeconds: 60 # 總寬限期（包括preStop）
4.2 配合就緒探針
在停機前標(biāo)記服務(wù)不可用：
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8080
5. 常見問題與解決方案
| 問題 | 解決方案 |
|---|---|
| 停機超時后仍有未完成請求 | 調(diào)整 spring.lifecycle.timeout-per-shutdown-phase 延長等待時間。 |
| 線程池任務(wù)未執(zhí)行完 | 自定義 ExecutorService 并在停機時調(diào)用 shutdown() 和 awaitTermination()。 |
| 數(shù)據(jù)庫連接未關(guān)閉 | 通過 @PreDestroy 或 DisposableBean 顯式關(guān)閉連接池。 |
| Kubernetes 強制終止 Pod | 確保 terminationGracePeriodSeconds 大于優(yōu)雅停機超時時間。 |
6. 驗證優(yōu)雅停機效果
1.發(fā)送長耗時請求：
curl http://localhost:8080/long-task
2.觸發(fā)停機：
curl -X POST http://localhost:8080/actuator/shutdown
3.觀察結(jié)果：
- 新請求返回
503 Service Unavailable。 - 正在處理的請求繼續(xù)執(zhí)行直至完成或超時。
總結(jié)
通過 內(nèi)嵌服務(wù)器配置、生命周期鉤子 和 Kubernetes 集成，Spring Boot 實現(xiàn)了開箱即用的優(yōu)雅停機功能。關(guān)鍵配置包括：
- 啟用 server.shutdown=graceful。
- 設(shè)置合理的超時時間。
- 結(jié)合 Actuator 端點或 Kubernetes 生命周期管理。
到此這篇關(guān)于一文帶你掌握springBoot如何做到優(yōu)雅停機的的文章就介紹到這了,更多相關(guān)springBoot停機內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要介紹了Java設(shè)計模式中的適配器模式，適配器模式(Adapter Pattern)將某個類的接口轉(zhuǎn)換成客戶端期望的另一個接口表示，主的目的是兼容性，讓原本因接口不匹配不能一起工作的兩個類可以協(xié)同工作。其別名為包裝器2022-07-07
在mybatis中sql是寫在xml映射文件中的，如果sql中有一些特殊字符的話，在解析xml文件的時候就會被轉(zhuǎn)義，下面我們就一起來看一下大于小于等于是怎么轉(zhuǎn)義的2021-04-04
SpringBoot中@Autowired注入service時出現(xiàn)循環(huán)依賴問題的解決方法
在Spring Boot開發(fā)過程中,@Autowired注入Service時出現(xiàn)循環(huán)依賴是一個常見問題,循環(huán)依賴指的是兩個或多個Bean相互依賴,形成閉環(huán),導(dǎo)致Spring容器無法正常初始化這些Bean,這里提供幾種解決Spring Boot中@Autowired注入Service時循環(huán)依賴問題的方法2024-02-02
springboot 中 druid+jpa+MYSQL數(shù)據(jù)庫配置過程
這篇文章主要介紹了springboot 中 druid+jpa+MYSQL數(shù)據(jù)庫配置,本文通過實例代碼給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-08-08
這篇文章主要介紹了mybatis-plus如何使用雪花算法ID生成策略，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-12-12
這篇文章主要為大家詳細(xì)介紹了Java經(jīng)典排序算法之插入排序，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-04-04
Quartz由Java編寫的功能豐富的開源作業(yè)調(diào)度框架,可以集成到幾乎任何Java應(yīng)用程序中,并且能夠創(chuàng)建多個作業(yè)調(diào)度,在實際的業(yè)務(wù)中,有很多場景依賴定時任務(wù),比如常見的：訂單超時處理,業(yè)務(wù)識別和預(yù)警通知等,本文介紹了SpringBoot3如何集成Quartz2023-08-08
如何在JDK 9中更簡潔使用 try-with-resources 語句
本文詳細(xì)介紹了自 JDK 7 引入的 try-with-resources 語句的原理和用法，以及介紹了 JDK 9 對 try-with-resources 的改進(jìn)，使得用戶可以更加方便、簡潔的使用 try-with-resources 語句。,需要的朋友可以參考下2019-06-06
本篇文章主要介紹了springmvc限流攔截器的示例代碼，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-12-12
這篇文章主要介紹了Jenkin郵件收發(fā)實現(xiàn)原理及過程詳解,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-09-09