ShutdownHook介绍
在java程序中,很容易在进程结束时添加一个钩子,即ShutdownHook。通常在程序启动时加入以下代码即可
1Runtime.getRuntime().addShutdownHook(new Thread(){ 2 @Override 3 public void run() { 4 System.out.println("I'm shutdown hook..."); 5 } 6});
有了ShutdownHook我们可以
- 在进程结束时做一些善后工作,例如释放占用的资源,保存程序状态等
- 为优雅(平滑)发布提供手段,在程序关闭前摘除流量
不少java中间件或框架都使用了ShutdownHook的能力,如dubbo、spring等。
spring中在application context被load时会注册一个ShutdownHook。
这个ShutdownHook会在进程退出前执行销毁bean,发出ContextClosedEvent等动作。
而dubbo在spring框架下正是监听了ContextClosedEvent,调用dubboBootstrap.stop()来实现清理现场和dubbo的优雅发布,spring的事件机制默认是同步的,所以能在publish事件时等待所有监听者执行完毕。
ShutdownHook原理
ShutdownHook的数据结构与执行顺序
- 当我们添加一个ShutdownHook时,会调用
ApplicationShutdownHooks.add(hook),往ApplicationShutdownHooks类下的静态变量private static IdentityHashMap<Thread, Thread> hooks添加一个hook,hook本身是一个thread对象 ApplicationShutdownHooks类初始化时会把hooks添加到Shutdown的hooks中去,而Shutdown的hooks是系统级的ShutdownHook,并且系统级的ShutdownHook由一个数组构成,只能添加10个- 系统级的ShutdownHook调用了thread类的
run方法,所以系统级的ShutdownHook是同步有序执行的
1private static void runHooks() { 2 for (int i=0; i < MAX_SYSTEM_HOOKS; i++) { 3 try { 4 Runnable hook; 5 synchronized (lock) { 6 // acquire the lock to make sure the hook registered during 7 // shutdown is visible here. 8 currentRunningHook = i; 9 hook = hooks[i]; 10 } 11 if (hook != null) hook.run(); 12 } catch(Throwable t) { 13 if (t instanceof ThreadDeath) { 14 ThreadDeath td = (ThreadDeath)t; 15 throw td; 16 } 17 } 18 } 19}
- 系统级的ShutdownHook的
add方法是包可见,即我们不能直接调用它 ApplicationShutdownHooks位于下标1处,且应用级的hooks,执行时调用的是thread类的start方法,所以应用级的ShutdownHook是异步执行的,但会等所有hook执行完毕才会退出。
1static void runHooks() { 2 Collection<Thread> threads; 3 synchronized(ApplicationShutdownHooks.class) { 4 threads = hooks.keySet(); 5 hooks = null; 6 } 7 8 for (Thread hook : threads) { 9 hook.start(); 10 } 11 for (Thread hook : threads) { 12 while (true) { 13 try { 14 hook.join(); 15 break; 16 } catch (InterruptedException ignored) { 17 } 18 } 19 } 20}
用一副图总结如下:

ShutdownHook触发点
从Shutdown的runHooks顺藤摸瓜,我们得出以下这个调用路径

重点看Shutdown.exit 和 Shutdown.shutdown
Shutdown.exit
跟进Shutdown.exit的调用方,发现有 Runtime.exit 和 Terminator.setup
Runtime.exit是代码中主动结束进程的接口Terminator.setup被initializeSystemClass调用,当第一个线程被初始化的时候被触发,触发后注册了一个信号监控函数,捕获kill发出的信号,调用Shutdown.exit结束进程
这样覆盖了代码中主动结束进程和被kill杀死进程的场景。
主动结束进程不必介绍,这里说一下信号捕获。在java中我们可以写出如下代码来捕获kill信号,只需要实现SignalHandler接口以及handle方法,程序入口处注册要监听的相应信号即可,当然不是每个信号都能捕获处理。
1public class SignalHandlerTest implements SignalHandler { 2 3 public static void main(String[] args) { 4 5 Runtime.getRuntime().addShutdownHook(new Thread() { 6 @Override 7 public void run() { 8 System.out.println("I'm shutdown hook "); 9 } 10 }); 11 12 SignalHandler sh = new SignalHandlerTest(); 13 Signal.handle(new Signal("HUP"), sh); 14 Signal.handle(new Signal("INT"), sh); 15 //Signal.handle(new Signal("QUIT"), sh);// 该信号不能捕获 16 Signal.handle(new Signal("ABRT"), sh); 17 //Signal.handle(new Signal("KILL"), sh);// 该信号不能捕获 18 Signal.handle(new Signal("ALRM"), sh); 19 Signal.handle(new Signal("TERM"), sh); 20 21 while (true) { 22 System.out.println("main running"); 23 try { 24 Thread.sleep(2000L); 25 } catch (InterruptedException e) { 26 e.printStackTrace(); 27 } 28 } 29 } 30 31 @Override 32 public void handle(Signal signal) { 33 System.out.println("receive signal " + signal.getName() + "-" + signal.getNumber()); 34 System.exit(0); 35 } 36}
要注意的是通常来说,我们捕获信号,做了一些个性化的处理后需要主动调用System.exit,否则进程就不会退出了,这时只能使用kill -9来强制杀死进程了。
而且每次信号的捕获是在不同的线程中,所以他们之间的执行是异步的。
Shutdown.shutdown
这个方法可以看注释
1/* Invoked by the JNI DestroyJavaVM procedure when the last non-daemon 2 * thread has finished. Unlike the exit method, this method does not 3 * actually halt the VM. 4 */
翻译一下就是该方法会在最后一个非daemon线程(非守护线程)结束时被JNI的DestroyJavaVM方法调用。
java中有两类线程,用户线程和守护线程,守护线程是服务于用户线程,如GC线程,JVM判断是否结束的标志就是是否还有用户线程在工作。
当最后一个用户线程结束时,就会调用 Shutdown.shutdown。这是JVM这类虚拟机语言特有的"权利",倘若是golang这类编译成可执行的二进制文件时,当全部用户线程结束时是不会执行ShutdownHook的。
举个例子,当java进程正常退出时,没有在代码中主动结束进程,也没有kill,就像这样
1public static void main(String[] args) { 2 3 Runtime.getRuntime().addShutdownHook(new Thread() { 4 @Override 5 public void run() { 6 super.run(); 7 System.out.println("I'm shutdown hook "); 8 } 9 }); 10}
当main线程运行完了后,也能打印出I'm shutdown hook,反观golang就做不到这一点(如果可以做到,可以私信告诉我,我是个golang新手)
通过如上两个调用的分析,我们概括出如下结论:

我们能看出java的ShutdownHook其实覆盖的非常全面了,只有一处无法覆盖,即当我们杀死进程时使用了kill -9时,由于程序无法捕获处理,进程被直接杀死,所以无法执行ShutdownHook。
总结
综上,我们得出一些结论
- 重写捕获信号需要注意主动退出进程,否则进程可能永远不会退出,捕获信号的执行是异步的
- 用户级的ShutdownHook是绑定在系统级的ShutdownHook之上,且用户级是异步执行,系统级是同步顺序执行,用户级处于系统级执行顺序的第二位
- ShutdownHook 覆盖的面比较广,不论是手动调用接口退出进程,还是捕获信号退出进程,抑或是用户线程执行完毕退出,都会执行ShutdownHook,唯一不会执行的就是kill -9
欢迎关注我的公众号"捉虫大师"

