You need to enable JavaScript to run this app. java.lang.ApplicationShutdownHooks内存泄漏导致Spring Boot应用崩溃如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 01:54:01