GraalVM Native Image在多JAR文件场景下的单核死锁问题分析

问题背景

在GraalVM 24版本中，当使用Native Image工具构建原生镜像时，如果同时满足以下两个条件，会出现构建过程死锁的问题：

1. 类路径（classpath）中包含多个JAR文件
2. 系统仅分配单个CPU核心给构建进程（通过taskset -c 0限制）

这个问题在GraalVM 23.0.2版本中不存在，表明这是新版本引入的回归问题。

问题复现

通过以下步骤可以稳定复现该问题：

1. 准备两个简单的Java类文件：

// Main.java
public class Main {
    public static void main(String[] args) {
        HelloWorld.sayHello();
    }
}

// HelloWorld.java
public class HelloWorld {
    public static void sayHello() {
        System.out.println("Hello, World!");
    }
}

2. 编译并打包：

javac Main.java
javac HelloWorld.java
jar cf Main.jar Main.class
jar cf HelloWorld.jar HelloWorld.class

3. 使用单核运行Native Image构建：

taskset -c 0 native-image -cp Main.jar:HelloWorld.jar Main -o MainApp

问题现象

构建过程会卡在类加载阶段，最终被看门狗（watchdog）检测为死锁而终止。错误日志显示主线程在等待ForkJoinTask完成，而实际上处理已经停滞。

技术分析

深入分析后发现，问题的根本原因在于：

1. GraalVM 24在类加载阶段使用了并行流（parallelStream）来处理多个JAR文件
2. 当系统仅有一个可用CPU核心时，ForkJoin框架的并行处理机制会出现问题
3. 特别是当处理JAR文件时调用FileSystems.newFileSystem()方法，在单核环境下容易导致线程阻塞

解决方案

Oracle团队已经通过以下方式解决了该问题：

1. 修改了类加载阶段的并行处理逻辑，避免在单核环境下使用并行流
2. 确保FileSystems.newFileSystem()的调用不会在受限的线程环境中造成阻塞

临时规避措施

在官方修复版本发布前，用户可以采用以下临时解决方案：

1. 为构建进程分配多个CPU核心：

taskset -c 0,1 native-image -cp Main.jar:HelloWorld.jar Main -o MainApp

2. 或者将JAR文件解压后使用目录作为类路径：

mkdir Main_dir && cd Main_dir && jar xf ../Main.jar && cd ..
mkdir HelloWorld_dir && cd HelloWorld_dir && jar xf ../HelloWorld.jar && cd ..
taskset -c 0 native-image -cp Main_dir:HelloWorld_dir Main -o MainApp

总结

这个问题展示了在并发编程中，特别是在资源受限环境下，并行处理机制可能带来的复杂性。GraalVM团队通过分析底层原因，找到了既保持性能又不影响稳定性的解决方案。对于开发者而言，这也提醒我们在使用并行流时需要充分考虑运行环境的特性。

该修复已经合并到GraalVM的主干代码中，预计将在下一个版本中发布。在此期间，受影响的用户可以采用上述临时解决方案继续开发工作。