如何优雅地关闭 Spring Boot 应用程序以响应系统终止信号-java教程-PHP中文网

Spring Boot 应用无法响应 kill -9 或 taskkill /f 等强制终止信号，但可通过 JVM 关闭钩子（Shutdown Hook）捕获 SIGTERM（Linux/macOS）或 Ctrl+C（Windows）等可拦截信号，执行事务回滚、连接释放、会话清理等优雅关闭逻辑。

spring boot 应用无法响应 `kill -9` 或 `taskkill /f` 等强制终止信号，但可通过 jvm 关闭钩子（shutdown hook）捕获 `sigterm`（linux/macos）或 ctrl+c（windows）等可拦截信号，执行事务回滚、连接释放、会话清理等优雅关闭逻辑。

在 Spring Boot 中实现优雅关闭（Graceful Shutdown），核心在于理解操作系统信号与 JVM 生命周期的交互机制：

✅ 可捕获的信号：SIGTERM（Linux/macOS）、Ctrl+C（Windows 控制台）、taskkill /pid （无 /f 参数时，Windows 发送 WM_CLOSE 类似软终止）——这些信号会触发 JVM 正常退出流程，从而运行注册的 Shutdown Hook 和 Spring 的生命周期回调。
❌ 不可捕获的信号：kill -9（SIGKILL）、taskkill /f /pid（强制终止）——操作系统直接杀死进程，跳过 JVM 任何回调，因此 @PreDestroy、SmartLifecycle.stop()、Shutdown Hook 均不会执行。这是 JVM 规范限制，无法绕过。

✅ 正确实现优雅关闭的推荐方式

1. 使用 JVM Shutdown Hook（通用可靠）

@Component
public class GracefulShutdownHook {

    private final ConfigurableApplicationContext applicationContext;

    public GracefulShutdownHook(ConfigurableApplicationContext applicationContext) {
        this.applicationContext = applicationContext;
        // 注册 JVM 关闭钩子（在应用启动时注册）
        Runtime.getRuntime().addShutdownHook(new Thread(() -> {
            System.out.println("[INFO] Received shutdown signal, initiating graceful shutdown...");
            try {
                // 手动触发 Spring 上下文关闭（触发 @PreDestroy、DisposableBean.destroy() 等）
                applicationContext.close();
                System.out.println("[SUCCESS] Spring context closed gracefully.");
            } catch (Exception e) {
                System.err.println("[ERROR] Failed to close application context: " + e.getMessage());
            }
        }, "spring-graceful-shutdown-hook"));
    }
}

? 提示：applicationContext.close() 会自动触发所有 @PreDestroy、DisposableBean、SmartLifecycle.stop() 及 ApplicationRunner/CommandLineRunner 的清理逻辑，无需重复编写。

2. 启用 Spring Boot 内置优雅关闭（推荐，更简洁）

Spring Boot 2.3+ 原生支持优雅关闭，只需配置 application.yml：

Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载

server:
  shutdown: graceful  # 启用优雅关闭（默认等待 30 秒）

spring:
  lifecycle:
    timeout-per-shutdown-phase: 60s  # 自定义超时时间

启用后，当收到 SIGTERM 或 Ctrl+C 时：

Web 容器（如 Tomcat）将停止接收新请求；
已接受的请求允许完成（受超时控制）；
Spring 容器按顺序销毁 Bean（触发 @PreDestroy 等）；
最终 JVM 退出，Shutdown Hook（如有）也会执行。

3. 配合自定义清理逻辑（如数据库连接池、消息监听器）

若需在关闭前执行特定操作（如确认未完成消息、刷新缓存），建议使用 SmartLifecycle：

@Component
public class PreShutdownCleaner implements SmartLifecycle {

    private volatile boolean isRunning = false;

    @Override
    public void start() {
        this.isRunning = true;
    }

    @Override
    public void stop() {
        System.out.println("➡️ Executing pre-shutdown cleanup...");
        // 例如：drain connection pool, ack unprocessed MQ messages, flush metrics...
        // 注意：此处应在超时内完成，否则会被强制中断
    }

    @Override
    public boolean isRunning() {
        return isRunning;
    }

    @Override
    public int getPhase() {
        return Integer.MAX_VALUE; // 确保最后启动、最先停止
    }
}

⚠️ 重要注意事项

@PreDestroy 不是 Shutdown Hook，它依赖 Spring 容器正常关闭流程，不会被 kill -9 触发；
Runtime.addShutdownHook() 是 JVM 层机制，仅对可协商的终止信号有效，且必须在 JVM 退出前注册（通常放在 @PostConstruct 或构造器中）；
生产环境部署（如 Docker/K8s）应确保发送 SIGTERM 而非 SIGKILL：K8s 默认先发 SIGTERM，等待 terminationGracePeriodSeconds 后再发 SIGKILL；
Windows 下 taskkill /pid 默认发送 WM_CLOSE（可被捕获），而 taskkill /f /pid 强制终止，务必避免在自动化脚本中滥用 /f。

✅ 总结

优雅关闭 ≠ 拦截所有 kill 信号，而是设计可中断、有超时、可恢复的终止流程。最佳实践是：
① 启用 server.shutdown=graceful；
② 必要时补充 Shutdown Hook 或 SmartLifecycle 做定制清理；
③ 在运维侧确保调用 SIGTERM（如 kill -15、K8s delete pod、Docker stop）；
④ 接受 SIGKILL 不可捕获的事实，通过监控、幂等设计和外部补偿机制保障最终一致性。