SpringBoot 应用优雅停机：正确关闭服务的 3 种方式
线上发布、重启服务时，你是不是直接kill -9一把梭？
后果往往是：
正在处理的请求直接中断，前端报错 502；
事务没提交，导致数据不一致；
线程池、连接池暴力关闭，资源泄漏；
MQ 消息消费一半，出现重复/丢失。
所谓优雅停机（Graceful Shutdown），就是让应用在关闭前：
停止接收新请求；
把正在处理的请求执行完；
释放线程池、连接池、MQ 消费者等资源；
最后再安全退出。
今天讲清楚 SpringBoot 优雅停机的3 种标准方案，生产直接抄配置。
一、什么是优雅停机？
简单说 4 件事：
不再接收新的 HTTP 请求 / 新消息
等待正在执行的业务执行完毕
自动关闭线程池、数据库连接、Redis 连接
安全退出 JVM，不丢数据、不中断事务
SpringBoot 2.3+ 已经内置支持，不用自己写复杂钩子。
二、方式1：配置文件开启内置优雅停机
1）application.yml 配置
1server: 2# 优雅停机最大等待时间（单位为秒） 3shutdown: graceful 4 5spring: 6 lifecycle: 7# 所有 Bean 关闭的最大等待时间 8timeout-per-shutdown-phase: 30sserver.shutdown: graceful：开启 Web 容器优雅停机
timeout-per-shutdown-phase: 30s：给 30 秒缓冲时间
2）支持的容器
Tomcat
Jetty
Undertow
全都通用，不用改代码。
三、方式2：Actuator 优雅停机
适合：发布平台、脚本自动化重启。
1）引入依赖
1<dependency> 2<groupId>org.springframework.bootgroupId> 3<artifactId>spring-boot-starter-actuatorartifactId> 4dependency>2）开启 shutdown 端点
1management: 2 endpoints: 3 web: 4 exposure: 5include: shutdown,health 6 endpoint: 7 shutdown: 8enabled:true3）远程调用关闭
1curl-X POST http://localhost:8080/actuator/shutdown应用会优雅停机，不是暴力杀进程。
4）生产安全提醒
一定要配合 Spring Security 权限控制
只对内网开放，不要暴露到公网
不要在生产随意打开
/actuator/shutdown
四、方式3：kill + 信号优雅停机
最常用、最推荐的生产方式。
正确命令
1kill PID 2# 或者 3kill-15 PID绝对禁止
1kill-9 PID # 暴力杀，不优雅，会丢数据！SpringBoot 会捕获SIGTERM信号，自动执行优雅停机流程。
五、如何保证自己的业务也“优雅”？
如果你有：
自定义线程池
MQ 消费者
定时任务
socket 长连接
需要加一个关闭钩子，保证资源释放。
1@Component 2publicclassAppShutdownHook{ 3 4@PreDestroy 5publicvoiddestroy(){ 6// 关闭线程池、消费者、连接等 7System.out.println("应用正在优雅关闭：清理自定义资源"); 8} 9}或者实现DisposableBean。
六、优雅停机完整流程
收到关闭信号（kill / actuator / 控制台停止）
Web 容器不再接受新请求
等待正在执行的 HTTP 请求完成
关闭 Spring 容器，执行
@PreDestroy关闭线程池、数据源、MQ 客户端
JVM 安全退出
整个过程在timeout时间内完成。
七、生产最佳实践
- 一律用 kill PID，禁止 kill -9
配置优雅停机超时 20~30s
发布脚本先切流量，再停机
自定义线程池/消费者必须加关闭钩子
用 Actuator 做自动化发布时开启权限
日志里观察停机日志，确认是 graceful 关闭
八、常见坑
- 超时时间太短
长接口、大事务没执行完就被关闭 → 加大
timeout - 用 kill -9
等于直接拔电源，任何优雅机制都失效
- 自定义线程池没关闭
应用关了，线程还在跑 → 用
@PreDestroy关闭 - Actuator 未授权暴露 shutdown
被人恶意调用，直接关服务