java.lang.ApplicationShutdownHooks内存泄漏导致Spring Boot应用崩溃如何解决?
定位与解决Spring Boot中ApplicationShutdownHooks内存泄漏方案
一、根因定位步骤
- 先获取堆转储快照:给应用添加JVM启动参数
-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path/to/dump,应用OOM时会自动生成堆转储文件;也可以在应用运行过程中手动执行命令jmap -dump:format=b,file=shutdown_hook_leak.hprof <进程ID>获取实时堆快照。 - 分析堆转储文件:使用Memory Analyzer Tool(MAT)打开快照文件,搜索
java.lang.ApplicationShutdownHooks类,查看其内部持有的hooks集合的大小和存储的对象。正常情况下该集合仅会存储个位数的系统级关闭钩子,若集合内存在数十上百个重复的钩子对象,即可确认泄漏存在。 - 定位泄漏代码点:重点排查两类逻辑:
- 项目代码中是否存在循环调用、重复调用
Runtime.getRuntime().addShutdownHook()的逻辑,尤其是原型作用域的Bean实例化、定时任务执行、请求处理链路中是否存在注册钩子的代码。 - 引入的第三方依赖是否存在重复注册钩子的问题,常见于旧版本的数据库连接池、消息队列客户端、分布式调度组件。
- 项目代码中是否存在循环调用、重复调用
二、修复方案
- 自定义钩子注册去重:如果业务逻辑必须手动注册关闭钩子,提前做去重处理,示例实现:
import java.util.Collections; import java.util.HashSet; import java.util.Set; public class ShutdownHookRegistry { private static final Set<Thread> REGISTERED_HOOKS = Collections.synchronizedSet(new HashSet<>()); public static void registerIfAbsent(Thread hook) { if (hook == null) { return; } if (REGISTERED_HOOKS.add(hook)) { Runtime.getRuntime().addShutdownHook(hook); } } }
- 优先使用Spring原生销毁逻辑:Spring管理的Bean需要执行关闭逻辑时,优先使用
@PreDestroy注解、实现DisposableBean接口,或者在@Bean注解中指定destroyMethod,不要手动注册关闭钩子,Spring上下文统一管理销毁逻辑不会出现重复注册问题。 - 第三方依赖问题修复:优先升级存在问题的第三方依赖到最新稳定版,此类内存泄漏问题一般会在后续版本被官方修复。如果无法升级,可以通过反射操作清理
ApplicationShutdownHooks中冗余的钩子对象,该操作属于非常规手段,仅作为兜底方案,上线前必须做充分测试避免误删正常钩子。 - 热部署场景适配:如果开启了Spring Boot DevTools热部署,在上下文销毁事件
ContextClosedEvent的监听逻辑中,手动移除当前上下文注册的自定义钩子,避免旧上下文的钩子残留累积。
三、效果验证
- 修复后执行长时间压测,每隔1小时执行命令
jmap -histo <进程ID> | grep java.lang.ApplicationShutdownHooks查看对象引用情况,若该对象关联的钩子数量长期稳定不增长,说明修复生效。 - 压测24小时后再次抓取堆转储文件,确认
ApplicationShutdownHooks的hooks集合大小正常,无冗余对象残留。
内容的提问来源于stack exchange,提问作者manu john
相关产品推荐
相关产品推荐

