Java调用新Jar后原Jar文件锁定无法释放的问题排查咨询

问题背景 #

• 开发环境：Java 17.0.8
• 业务流程：A.jar启动时检查更新，下载新版本后启动B.jar，随后A.jar执行exit(0)退出JVM
• 异常现象：JVM关闭后A.jar仍被系统锁定，导致B.jar无法覆盖替换A.jar；但手动退出A.jar再启动B.jar则正常，尝试cmd /c nohup启动B.jar也无效
• 调试结果：新建极简项目编译A.jar、B.jar、A2.jar可正常完成更新替换，说明问题出在现有项目的代码或依赖库中，但因项目规模大难以定位

可能的锁定原因及排查方向 #

1. 未关闭的文件流或资源 #

即使没有直接操作A.jar文件，项目中也可能存在间接打开Jar内资源但未释放的情况：

• 比如用ClassLoader.getResourceAsStream()读取Jar内配置、资源后，未调用close()关闭流
• 第三方库（如日志框架、配置加载工具）可能在内部打开了Jar资源但未正确释放
• 排查方式：
  • 在A.jar退出前临时调用System.gc()触发垃圾回收（仅用于调试），观察是否能解锁
  • 用Windows的资源监视器（搜索“关联的句柄”）或Linux的lsof | grep A.jar命令，查看哪个进程/线程持有Jar文件句柄
  • 添加JVM参数-XX:+PrintGCDetails，观察垃圾回收是否正常回收资源

2. 非守护线程未正常终止 #

JVM执行exit(0)时，若存在非守护线程仍在运行，会导致JVM无法完全关闭，进而持有Jar句柄：

• 检查自定义线程是否未设置setDaemon(true)，且未在退出时手动中断
• 第三方库可能启动了后台线程（如定时任务、心跳线程）未正确停止
• 排查方式：
  • 在exit(0)前打印所有线程状态，确认是否有非守护线程存活：

    Thread.getAllStackTraces().keySet().forEach(t -> 
        System.out.println(t.getName() + " | 守护线程: " + t.isDaemon() + " | 状态: " + t.getState())
    );
    

  • 注册JVM关闭钩子，在退出时强制中断非守护线程：

    Runtime.getRuntime().addShutdownHook(new Thread(() -> {
        Thread.getAllStackTraces().keySet().stream()
            .filter(t -> !t.isDaemon() && !t.equals(Thread.currentThread()))
            .forEach(t -> {
                t.interrupt();
                System.out.println("中断线程: " + t.getName());
            });
    }));
    

3. ClassLoader或类加载机制持有Jar引用 #

• 自定义ClassLoader加载了A.jar中的类，但未被正确回收，导致Jar文件句柄被持有
• 热加载框架、动态代理库可能保留了对Jar文件的引用
• 排查方式：
  • 临时关闭项目中的热加载、动态代理功能，测试更新流程是否正常
  • 添加JVM参数-XX:+TraceClassUnloading，跟踪A.jar中的类是否被正常卸载

4. 系统级第三方进程锁定 #

Windows系统下，杀毒软件、资源管理器、实时备份工具等第三方进程可能扫描或占用A.jar：

• 排查方式：关闭杀毒软件、实时备份工具，重试更新流程；用资源监视器确认锁定A.jar的进程是否为Java进程

快速验证方案 #

1. 逐步移除第三方依赖库，每次移除后测试更新流程，定位到导致锁定的依赖
2. 在A.jar启动B.jar后，延迟3-5秒再执行exit(0)，给资源回收留缓冲时间
3. 用ProcessBuilder启动B.jar时关闭IO继承，避免资源持有：

   ProcessBuilder pb = new ProcessBuilder("java", "-jar", "B.jar");
   pb.inheritIO(false);
   pb.start();
   

内容的提问来源于stack exchange，提问作者Fraŋkini