Java记录System.exit()触发时的调用栈信息

通过注册 JVM 关闭钩子（shutdown hook），可在 System.exit() 执行后、JVM 终止前捕获并记录所有线程的当前堆栈信息，从而定位 exit 调用源头，无需启用 SecurityManager。

在 Java 应用开发中，最令人头疼的场景之一便是服务毫无征兆地悄然终止，翻遍日志也找不到异常，最终发现祸首是某处调用了 System.exit()。排查此类问题如同大海捞针——既没有堆栈信息，也没有任何提示，只能靠猜测。

过去，开发者可以使用 SecurityManager 拦截 exit() 调用，借此抛出异常或记录日志。然而，自 Java 17 起，SecurityManager 已被标记为弃用，引入它还会带来额外的复杂性和兼容性风险。实际上，有一个更轻量、更标准的解决方案：直接利用 JVM 内置的 Shutdown Hook。当 System.exit() 被触发时，JVM 会按照关闭流程执行，而 Shutdown Hook 正好在关闭流程启动后、虚拟机真正终止前运行。此时抓取所有线程的堆栈快照，便能精准定位 exit 的调用位置。

以下是一个简洁可靠的实现，可直接复制到项目中使用：

import ja va.util.Arrays;
import ja va.util.Map;
import ja va.util.logging.Logger;

public class ExitTraceHook {
    private static final Logger LOG = Logger.getLogger(ExitTraceHook.class.getName());

    public static void installExitTracingHook() {
        Thread shutdownHook = new Thread(() -> {
            LOG.info("JVM shutdown initiated — capturing thread stack traces...");
            Map allStacks = Thread.getAllStackTraces();
            for (Map.Entry entry : allStacks.entrySet()) {
                Thread t = entry.getKey();
                StackTraceElement[] stack = entry.getValue();
                // 过滤掉 Finalizer、Reference Handler 等系统线程，聚焦用户线程
                if (t.getName().startsWith("main") || !t.isDaemon()) {
                    LOG.info(String.format("Thread [%s] state: %s", t.getName(), t.getState()));
                    LOG.fine(Arrays.toString(stack));
                }
            }
        }, "exit-trace-shutdown-hook");
        // 设为守护线程，避免自身阻塞 JVM 退出
        shutdownHook.setDaemon(true);
        Runtime.getRuntime().addShutdownHook(shutdownHook);
    }
}

使用方法：在应用启动的早期阶段——例如 main()ApplicationRunner 或静态初始化块中——调用 ExitTraceHook.installExitTracingHook() 即可。一行代码就能让应用具备事后追溯能力。

需要特别注意以下几个关键点：

• Shutdown Hook 无法阻止 System.exit() 的执行，它只负责事后诊断，相当于一个“现场录像机”。
• 它运行的时机恰好是 exit() 被触发的那一刻，因此记录的堆栈快照能够真实反映 exit 调用时的现场环境。主线程的堆栈信息通常能直接暴露调用位置。
• 钩子函数中千万不要执行耗时或阻塞操作（例如网络请求、未缓冲的文件写入），否则会拖慢 JVM 关闭速度，甚至导致超时强制终止。
• 如果应用调用的是 Runtime.halt()（直接强制终止），Shutdown Hook 不会触发，此方案将无法生效。
• 在生产环境中建议将堆栈输出的日志级别设为较低等级（如 FINE），避免正常的 INFO 日志被淹没。

总的来说，Shutdown Hook 是一种标准、无侵入、兼容性强的诊断手段。搭配成熟的日志框架（Logback、Log4j 等）以及结构化日志输出，能够显著缩短排查非法 System.exit() 的时间。如果遇到莫名其妙的服务终止问题，不妨先安装这个钩子——下次再出异常时，就有现场证据可供分析。