線上發(fā)布、重啟服務時，你是不是直接 kill -9 一把梭？
后果往往是：

• 正在處理的請求直接中斷，前端報錯 502；
• 事務沒提交，導致數(shù)據(jù)不一致；
• 線程池、連接池暴力關閉，資源泄漏；
• MQ 消息消費一半，出現(xiàn)重復/丟失。

所謂優(yōu)雅停機（Graceful Shutdown），就是讓應用在關閉前：

• 停止接收新請求；
• 把正在處理的請求執(zhí)行完；
• 釋放線程池、連接池、MQ 消費者等資源；
• 最后再安全退出。

今天講清楚 SpringBoot 優(yōu)雅停機的 3 種標準方案，生產(chǎn)直接抄配置。

一、什么是優(yōu)雅停機？

簡單說 4 件事：

1. 不再接收新的 HTTP 請求 / 新消息
2. 等待正在執(zhí)行的業(yè)務執(zhí)行完畢
3. 自動關閉線程池、數(shù)據(jù)庫連接、Redis 連接
4. 安全退出 JVM，不丟數(shù)據(jù)、不中斷事務

SpringBoot 2.3+ 已經(jīng)內(nèi)置支持，不用自己寫復雜鉤子。

二、方式1：配置文件開啟內(nèi)置優(yōu)雅停機

1）application.yml 配置

server:
# 優(yōu)雅停機最大等待時間（單位為秒）
shutdown: graceful
spring:
  lifecycle:
# 所有 Bean 關閉的最大等待時間
timeout-per-shutdown-phase: 30s

server.shutdown: graceful

：開啟 Web 容器優(yōu)雅停機

timeout-per-shutdown-phase: 30s

：給 30 秒緩沖時間

2）支持的容器

• Tomcat
• Jetty
• Undertow

全都通用，不用改代碼。

三、方式2：Actuator 優(yōu)雅停機

適合：發(fā)布平臺、腳本自動化重啟。

1）引入依賴

<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-actuatorartifactId>
<dependency>

2）開啟 shutdown 端點

management:
  endpoints:
    web:
      exposure:
include: shutdown,health
  endpoint:
    shutdown:
enabled:true

3）遠程調(diào)用關閉

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

應用會優(yōu)雅停機，不是暴力殺進程。

4）生產(chǎn)安全提醒

• 一定要配合 Spring Security 權限控制
• 只對內(nèi)網(wǎng)開放，不要暴露到公網(wǎng)
• 不要在生產(chǎn)隨意打開 /actuator/shutdown

四、方式3：kill + 信號優(yōu)雅停機

最常用、最推薦的生產(chǎn)方式。

正確命令

kill PID
# 或者
kill-15 PID

絕對禁止

kill-9 PID   # 暴力殺，不優(yōu)雅，會丟數(shù)據(jù)！

SpringBoot 會捕獲 SIGTERM 信號，自動執(zhí)行優(yōu)雅停機流程。

五、如何保證自己的業(yè)務也“優(yōu)雅”？

如果你有：

• 自定義線程池
• MQ 消費者
• 定時任務
• socket 長連接

需要加一個關閉鉤子，保證資源釋放。

@Component
publicclassAppShutdownHook{
@PreDestroy
publicvoiddestroy(){
// 關閉線程池、消費者、連接等
System.out.println("應用正在優(yōu)雅關閉：清理自定義資源");
}
}

或者實現(xiàn) DisposableBean。

六、優(yōu)雅停機完整流程

1. 收到關閉信號（kill / actuator / 控制臺停止）
2. Web 容器不再接受新請求
3. 等待正在執(zhí)行的 HTTP 請求完成
4. 關閉 Spring 容器，執(zhí)行 @PreDestroy
5. 關閉線程池、數(shù)據(jù)源、MQ 客戶端
6. JVM 安全退出

整個過程在 timeout 時間內(nèi)完成。

七、生產(chǎn)最佳實踐

1. 一律用 kill PID，禁止 kill -9
2. 配置優(yōu)雅停機超時 20~30s
3. 發(fā)布腳本先切流量，再停機
4. 自定義線程池/消費者必須加關閉鉤子
5. 用 Actuator 做自動化發(fā)布時開啟權限
6. 日志里觀察停機日志，確認是 graceful 關閉

八、常見坑

超時時間太短

長接口、大事務沒執(zhí)行完就被關閉 → 加大 timeout

用 kill -9

等于直接拔電源，任何優(yōu)雅機制都失效

自定義線程池沒關閉

應用關了，線程還在跑 → 用 @PreDestroy 關閉

Actuator 未授權暴露 shutdown

被人惡意調(diào)用，直接關服務

到此這篇關于SpringBoot應用優(yōu)雅停機的3種標準方案的文章就介紹到這了,更多相關SpringBoot優(yōu)雅停機方案內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論