Java17+SpringBoot3异步方法Docker部署报JAXB实现未找到求助

项目环境与异步配置 #

项目基于Java 17和SpringBoot 3，自定义异步线程池配置如下：

@Configuration
@EnableAsync
public class AsyncConfig {
    @Bean(name = "taskExecutor")
    public Executor taskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        executor.setCorePoolSize(5);
        executor.setMaxPoolSize(10);
        executor.setQueueCapacity(100);
        executor.setThreadNamePrefix("Async-");
        executor.initialize();
        return executor;
    }
}

异步方法实现 #

@Async("taskExecutor")
public CompletableFuture<Response<Exception>> createOrUpdateEntryAsync(
        .....,
        @Nullable ProgressListener progressListener) {

    return CompletableFuture.supplyAsync(() -> createOrUpdateEntry(
        ......,
        progressListener));
}

问题现象 #

本地IntelliJ开发调试时方法运行正常，但使用openjdk:17-jdk-slim作为基础镜像打包Docker部署后，调用异步方法抛出错误：
"Implementation of JAXB-API has not been found on module path or classpath"

已尝试的无效方案 #

添加了以下Maven依赖，但问题未解决：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.2</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.3</version>
</dependency>

异常栈片段 #

java.base/java.util.concurrent.CompletableFuture$AsyncSupply.run(CompletableFuture.java:1768)
java.base/java.util.concurrent.CompletableFuture$AsyncSupply.exec(CompletableFuture.java:1760)
java.base/java.util.concurrent.ForkJoinTask.doExec(ForkJoinTask.java:373)
java.base/java.util.concurrent.ForkJoinPool$WorkQueue.topLevelExec(ForkJoinPool.java:1182)
java.base/java.util.concurrent.ForkJoinPool.scan(ForkJoinPool.java:1655)
java.base/java.util.concurrent.ForkJoinPool.runWorker(ForkJoinPool.java:1622)
java.base/java.util.concurrent.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:165)

解决建议 #

1. 替换为Jakarta EE规范的JAXB依赖
   Java 17和SpringBoot 3已全面切换到Jakarta EE，原javax.xml.bind包的依赖已过时，需改用Jakarta版本：

<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <version>4.0.0</version>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>4.0.2</version>
    <scope>runtime</scope>
</dependency>

2. 修正异步方法的线程池使用
   当前方法通过@Async指定了自定义线程池，但内部又调用CompletableFuture.supplyAsync()（默认使用ForkJoinPool），可能导致类加载上下文不一致。建议直接在自定义线程池中执行任务：

@Async("taskExecutor")
public CompletableFuture<Response<Exception>> createOrUpdateEntryAsync(
        .....,
        @Nullable ProgressListener progressListener) {
    Response<Exception> result = createOrUpdateEntry(......, progressListener);
    return CompletableFuture.completedFuture(result);
}

3. 验证Docker打包的依赖完整性

• 执行mvn dependency:tree确认JAXB相关依赖已被正确引入
• 检查Dockerfile是否正确复制了完整的可执行jar包（确保依赖未被遗漏）

4. 模块化项目补充配置
   如果项目使用Java模块系统，需在JVM启动参数中添加：

--add-modules jakarta.xml.bind

或在module-info.java中声明：

requires jakarta.xml.bind;

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