CompletableFuture.runAsync调用JAXB-API出现模块未找到异常的原因

核心原因 #

• 类加载器上下文不一致：CompletableFuture.runAsync()默认使用ForkJoinPool中的线程，这些线程的上下文类加载器通常是系统类加载器，而主线程使用的是应用类加载器。JAXB的实现类（如jaxb-impl）仅被应用类加载器加载，导致异步线程无法找到这些类。
• 模块化环境的可见性限制：Java 9+模块化项目中，主线程通过module-info.java声明了JAXB相关模块依赖，但异步线程的模块上下文未继承该依赖，导致模块路径下的JAXB实现无法被访问。
• 延迟加载的类加载差异：直接调用时，JAXB相关类在主线程提前被加载，类加载器已缓存这些类；异步调用时，线程类加载器未加载过这些类，且无法从自身类路径找到对应的JAR包。

解决办法 #

1. 同步上下文类加载器 #

在异步任务中手动设置线程的上下文类加载器为主线程的类加载器，确保能找到JAXB实现：

// 先获取主线程的类加载器
ClassLoader appClassLoader = Thread.currentThread().getContextClassLoader();

CompletableFuture.runAsync(() -> {
    Thread.currentThread().setContextClassLoader(appClassLoader);
    testFunc(); // 执行JAXB操作
});

2. 确保JAXB依赖全局可见 #

如果使用Maven/Gradle，确保JAXB的API和实现依赖被正确引入且作用域为全局（避免provided等受限作用域）：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.1</version>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0.1</version>
</dependency>

3. 模块化项目声明依赖 #

在module-info.java中显式声明JAXB相关模块的依赖，保证模块上下文可见：

module your.module.name {
    requires javax.xml.bind;
    requires com.sun.xml.bind;
}

4. 自定义线程池 #

不使用默认的ForkJoinPool，创建自定义线程池并统一设置线程的上下文类加载器：

ExecutorService customExecutor = Executors.newFixedThreadPool(4, runnable -> {
    Thread thread = new Thread(runnable);
    thread.setContextClassLoader(Thread.currentThread().getContextClassLoader());
    return thread;
});

CompletableFuture.runAsync(() -> testFunc(), customExecutor);
// 使用完毕记得关闭线程池
// customExecutor.shutdown();

内容的提问来源于stack exchange，提问作者vishal