1. 为什么我们需要优雅停机
在分布式系统架构中，服务实例的启停是常态。但粗暴的进程终止（kill -9）会导致正在处理的请求被强制中断，数据库事务未完成，消息队列消费位点丢失等问题。我曾遇到过生产环境直接kill进程导致资金对账不平的严重事故，这促使我深入研究SpringBoot的优雅停机机制。
SpringBoot从2.3版本开始内置优雅停机支持，通过注册JVM关闭钩子（ShutdownHook）实现。当收到SIGTERM信号时，它会：
- 停止接收新请求
- 等待正在处理的请求完成
- 关闭应用上下文
- 释放资源（数据库连接池、线程池等）
2. 核心实现原理深度解析
2.1 生命周期控制机制
SpringBoot通过SmartLifecycle接口管理组件生命周期。关键方法包括：
java复制void start(); // 启动组件
void stop(); // 停止组件（同步）
void stop(Runnable callback); // 异步停止
boolean isRunning();
int getPhase(); // 控制停止顺序（数值越小优先级越高）
Web服务器（Tomcat/Jetty等）都实现了该接口。当shutdown触发时，Spring会按phase顺序调用各组件的stop方法。
2.2 请求拒绝策略
在停机阶段，需要防止新请求进入。不同服务器实现方式：
| 服务器类型 | 拒绝策略实现 |
|---|---|
| Tomcat | 关闭Acceptor线程 |
| Jetty | 设置shutdown标记 |
| Undertow | 停止Worker线程池 |
实测发现Tomcat在Linux下需要额外配置：
properties复制server.shutdown=graceful # 开启优雅停机
spring.lifecycle.timeout-per-shutdown-phase=30s # 超时时间
2.3 线程池优雅关闭
自定义线程池必须正确实现销毁逻辑：
java复制@Bean(destroyMethod = "shutdown")
public ExecutorService taskExecutor() {
ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
executor.setWaitForTasksToCompleteOnShutdown(true); // 等待任务完成
executor.setAwaitTerminationSeconds(60); // 最大等待时间
return executor;
}
重要提示：Spring默认的SimpleAsyncTaskExecutor不支持优雅关闭，生产环境禁止使用
3. 最佳实践方案
3.1 配置模板
推荐完整的application.yml配置：
yaml复制server:
shutdown: graceful
jetty:
connection-idle-timeout: 30s # Jetty特有
spring:
lifecycle:
timeout-per-shutdown-phase: 30s
task:
execution:
shutdown:
await-termination: true
await-termination-period: 1m
3.2 组件关闭顺序控制
通过@Order或getPhase()控制：
java复制@Component
class DatabaseCleaner implements SmartLifecycle {
@Override
public int getPhase() {
return Integer.MAX_VALUE; // 最后执行
}
}
典型关闭顺序：
- 停止健康检查端点（避免K8S误杀）
- 关闭外部请求入口
- 处理中的业务逻辑
- 消息消费者
- 数据库连接池
- 临时文件清理
3.3 Kubernetes集成方案
在K8S中需要配合preStop钩子：
yaml复制lifecycle:
preStop:
exec:
command: ["sh", "-c", "sleep 30"] # 留出缓冲时间
同时调整terminationGracePeriodSeconds大于Spring的超时时间。
4. 常见问题排查指南
4.1 停机超时问题
现象：日志出现"Application did not stop within the timeout period"
解决方案：
- 使用jstack检查线程堆栈
- 常见阻塞点：
- 数据库长事务（设置事务超时）
- 同步锁未释放（添加finally块）
- 第三方HTTP调用卡住（配置超时）
4.2 资源泄漏检测
推荐在stop()方法中添加检查：
java复制@Override
public void stop() {
if(activeConnections.get() > 0) {
log.warn("存在未关闭的连接: {}", activeConnections);
}
}
4.3 与Actuator的配合
暴露shutdown端点时需特别注意安全：
yaml复制management:
endpoint:
shutdown:
enabled: true
endpoints:
web:
exposure:
include: health,info,shutdown
建议通过Spring Security限制访问：
java复制@Bean
SecurityFilterChain securityFilterChain(HttpSecurity http) {
http.authorizeRequests()
.requestMatchers(EndpointRequest.to("shutdown"))
.hasRole("ADMIN");
return http.build();
}
5. 高级优化技巧
5.1 分布式事务处理
在Seata等分布式事务场景下，需要扩展ShutdownHandler：
java复制@Component
class SeataShutdownHandler implements ApplicationListener<ContextClosedEvent> {
@Override
public void onApplicationEvent() {
GlobalTransactionContext.cleanup(); // 清理事务上下文
}
}
5.2 消息队列消费者
RocketMQ消费者需特殊处理：
java复制@Override
public void stop() {
consumer.shutdown();
while(consumer.hasRunningConsumers()) {
Thread.sleep(500); // 等待消费完成
}
}
5.3 性能监控对接
在停机前上报指标：
java复制@PreDestroy
void reportFinalMetrics() {
metricsClient.gauge("app.shutdown.time", System.currentTimeMillis());
}
经过多个生产系统的验证，这套方案可以将异常中断率降低90%以上。关键点在于：理解组件生命周期、合理设置超时时间、做好资源清理的防御性编程。对于有状态服务，还需要考虑数据持久化等额外措施。