当前位置：首页 > ops >正文

Spring Boot 应用优雅停机与资源清理：深入理解关闭钩子

ops 2025/7/19 8:50:36

在开发和部署 Spring Boot 应用程序时，除了关注其启动和运行，理解如何实现**优雅停机（Graceful Shutdown）**也同样至关重要。优雅停机意味着在应用程序关闭时，能够有序地释放资源、完成正在进行的任务，并避免数据丢失或损坏。本文将深入探讨 Spring Boot 中与优雅停机相关的机制，特别是 JVM 关闭钩子以及如何自定义清理逻辑。

1. 什么是 Spring Boot 的关闭钩子？

在 Spring Boot 应用程序的启动过程中，你可能会注意到类似以下的代码片段（通常在 SpringApplication.class 中）：

// ... existing code ...
if (this.properties.isRegisterShutdownHook()) {SpringApplication.shutdownHook.enableShutdownHookAddition();
}
// ... existing code ...

这段代码的核心在于 this.properties.isRegisterShutdownHook()。它对应于 Spring Boot 配置中的 spring.main.register-shutdown-hook 属性。

spring.main.register-shutdown-hook: 这个配置属性（默认为 true）决定了 Spring Boot 应用程序是否会在 JVM 启动时注册一个关闭钩子（Shutdown Hook）。
SpringApplication.shutdownHook.enableShutdownHookAddition(): 当 spring.main.register-shutdown-hook 为 true 时，此方法会被调用，它负责向 JVM 运行时环境注册一个钩子。当 JVM 接收到外部的关闭信号（如 Ctrl+C、kill <pid> 命令等，而非强制终止的 kill -9）时，这个钩子就会被激活。

简而言之，注册关闭钩子的目的是让 Spring Boot 有机会在 JVM 正常关闭前，执行一系列预定义的清理操作，从而确保应用程序的优雅停机。 这些操作可能包括关闭数据库连接池、释放文件句柄、停止后台线程等。

2. 如何自定义关闭时的清理逻辑？

Spring Boot 提供了灵活的机制来允许开发者在应用程序关闭时执行自定义的清理逻辑。主要有两种常用且推荐的方式：监听 ContextClosedEvent 和使用 @PreDestroy 注解。

2.1 监听 `ContextClosedEvent`

这是最推荐的方式，因为它与 Spring 应用程序上下文的生命周期事件紧密集成。当 Spring 应用程序上下文完成其所有 Bean 的销毁并准备关闭时，会发布 ContextClosedEvent。

如何定义：

创建一个实现 org.springframework.context.ApplicationListener<ContextClosedEvent> 接口的类。
在 onApplicationEvent 方法中编写你的全局清理逻辑。
使用 @Component 注解将其注册为 Spring Bean。

示例：

// src/main/java/com/dosun/demo01/listener/MyCleanupListener.java
package com.dosun.demo01.listener;import org.springframework.context.ApplicationListener;
import org.springframework.context.event.ContextClosedEvent;
import org.springframework.stereotype.Component;@Component
public class MyCleanupListener implements ApplicationListener<ContextClosedEvent> {@Overridepublic void onApplicationEvent(ContextClosedEvent event) {System.out.println("应用程序上下文已关闭。执行自定义清理逻辑...");// 在这里编写你的自定义清理逻辑，例如：// 1. 关闭数据库连接// 2. 释放文件句柄// 3. 停止线程池// 4. 清理缓存等System.out.println("自定义清理逻辑执行完毕。");}
}

当应用程序正常关闭时，onApplicationEvent 方法会被调用，从而执行你在其中定义的清理代码。

2.2 使用 `@PreDestroy` 注解

对于 Spring 容器管理的特定 Bean，你可以使用 @PreDestroy 注解来标记一个方法。这个方法会在该 Bean 被销毁之前执行。这对于 Bean 级别的资源清理非常有用。

如何定义：

在任何 Spring 管理的 Bean 中，在你希望执行 Bean 特定清理逻辑的方法上添加 @PreDestroy 注解。

示例：

package com.dosun.demo01.service;import org.springframework.stereotype.Service;
import jakarta.annotation.PreDestroy;@Service
public class MyService {public MyService() {System.out.println("MyService Bean 已创建。");}@PreDestroypublic void cleanup() {System.out.println("MyService Bean 即将被销毁。执行 Bean 级别的清理逻辑...");// 在这里编写 MyService 特定的清理逻辑，例如关闭 MyService 内部的连接System.out.println("MyService Bean 级别的清理逻辑执行完毕。");}public void doSomething() {System.out.println("MyService 正在执行一些操作。");}
}

2.3 如何选择？

ContextClosedEvent: 适用于需要在整个应用程序关闭时执行的全局清理任务。它在所有 Bean 都被销毁之后，但在 JVM 真正退出之前执行。例如，全局的日志系统清理、一些共享资源的释放等。
@PreDestroy: 适用于特定 Bean 的清理任务。它在该 Bean 被销毁之前执行。例如，某个 Bean 内部持有的数据库连接、线程池、文件句柄等资源的释放。

在大多数情况下，监听 ContextClosedEvent 会是更灵活和通用的选择，因为你可以在一个地方集中管理所有应用程序级别的关闭逻辑。

3. `spring.main.register-shutdown-hook` 为 `false` 的影响

现在我们来讨论一个关键问题：如果 spring.main.register-shutdown-hook 被设置为 false，清理钩子是不是就不生效了？

答案是：是的，在大多数情况下，自定义的清理钩子将不会生效，或者说无法在应用程序接收到正常关闭信号时被优雅地触发。

具体影响如下：

对于监听 ContextClosedEvent 的自定义清理逻辑：
如果 spring.main.register-shutdown-hook 为 false，Spring Boot 将不会向 JVM 注册关闭钩子。这意味着当 JVM 收到 Ctrl+C 或 kill <pid> 等正常的关闭信号时，Spring Boot 应用程序将无法通过其内部的关闭钩子机制来优雅地关闭 Spring 应用程序上下文。因此，你的 MyCleanupListener 中监听 ContextClosedEvent 的 onApplicationEvent 方法将不会被触发。
对于使用 @PreDestroy 注解的方法：
@PreDestroy 注解的方法是在 Spring Bean 被销毁之前调用的，这是 Spring 容器生命周期的一部分。
- 如果 Spring 应用程序上下文能够被正常关闭（例如，你在代码中手动调用了 SpringApplication.exit() 或 ApplicationContext.close()），那么即使 spring.main.register-shutdown-hook 为 false，@PreDestroy 方法仍然会被调用。
- 但是，在通常的场景下，如果 spring.main.register-shutdown-hook 为 false，并且你期望通过操作系统信号（如 Ctrl+C）来关闭应用程序，那么 JVM 不会通知 Spring 执行其关闭逻辑。Spring 容器就无法执行其正常的销毁流程，包括调用 @PreDestroy 方法。应用程序可能会突然终止，导致资源未释放，数据不一致等问题。

总结来说：

spring.main.register-shutdown-hook 配置是 Spring Boot 实现应用程序优雅停机的关键。

如果设置为 true（默认值且推荐）：Spring 会注册 JVM 关闭钩子，确保在应用程序因外部信号而关闭时，ContextClosedEvent 监听器和 @PreDestroy 方法都能得到执行，从而进行必要的清理。
如果设置为 false：Spring 将不会注册这个 JVM 关闭钩子。这意味着当应用程序收到 Ctrl+C 或 kill 等信号时，Spring 应用程序上下文将不会被优雅关闭。那些依赖 Spring 正常关闭流程的清理逻辑（包括 ContextClosedEvent 和通常情况下的 @PreDestroy）将不会生效。这可能导致应用程序资源未释放、数据不一致等问题。