shutdown hook 是 jvm 正常关闭时唯一被保证执行的清理入口，用于显式释放数据库连接、网络资源等外部资源，需轻量、带超时，不可发起新远程调用或依赖未初始化 bean。
Java 中 JVM 退出机制本身不自动释放外部资源，真正起作用的是 Shutdown Hook——它是在 JVM 正常关闭流程中唯一被保证执行的清理入口。关键不是“怎么退出”，而是“在退出前把该关的都关掉”。
Shutdown Hook 是什么、什么时候会运行
Shutdown Hook 是一个未启动的 Thread 对象，通过 Runtime.getRuntime().addShutdownHook() 注册后，会在以下情况触发执行：
- 调用
System.exit() - 收到
SIGTERM（如kill -15、K8s 发起优雅终止） - 用户按
Ctrl+C - 最后一个非守护线程结束
它不会运行在这些场景下：kill -9、Runtime.halt()、JVM 崩溃、OOM 直接宕机、断电等非受控终止。因此不能把它当作“万能兜底”，而应是“最后一道防线”。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
钩子里该做什么：轻量、显式、带超时
外部资源（数据库连接池、Netty EventLoopGroup、文件句柄、日志上下文等）不会自动释放，必须在钩子中显式调用关闭方法，且每一步都要控制耗时：
- 对 HikariCP 数据源：调
dataSource.close()或HikariDataSource.close() - 对 Netty：调
eventLoopGroup.shutdownGracefully().await(3, TimeUnit.SECONDS)，并捕获InterruptedException后恢复中断状态 - 对 Logback：获取
LoggerContext并调stop()；对 Log4j2，需确保异步日志器已 flush - 对临时文件或锁：检查
FileChannel或RandomAccessFile是否打开，再close() - 所有网络调用（如下线通知）必须设超时，建议 ≤ 2 秒，避免阻塞整个关闭流程
哪些操作绝对不能在钩子里做
钩子线程运行环境受限，以下行为容易导致卡死、丢失数据或静默失败：
- 发起新的 HTTP 请求、远程 RPC 或数据库写入（连接可能已断、服务已不可用）
- 使用
Thread.join()等待其他业务线程——主线程可能早已退出，等待无意义 - 调用
System.exit()或Runtime.halt()——造成未定义行为 - 依赖尚未初始化或已被销毁的 Spring Bean（Web 应用应优先走
ApplicationContext.close()） - 在钩子里读取 volatile 变量以外的业务状态——此时对象引用可能已失效或被 GC
和框架配合更可靠：别只靠裸钩子
对于 Spring Boot 等现代框架，手动注册 Shutdown Hook 是补充手段，不是首选：
- 启用 Actuator 的
/actuator/shutdown端点，通过 HTTP 触发标准关闭流程 - 调用
SpringApplication.exit(context, exitCode)，它会触发 Bean 销毁、连接池归还、事件广播等完整生命周期 - 在配置类中调用
context.registerShutdownHook()，比手写addShutdownHook更安全（自动处理上下文状态） - 数据库连接、HTTP 客户端等尽量交由连接池管理，并开启自动回收（如 HikariCP 的
leakDetectionThreshold），降低对钩子的依赖
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
