Azure部署的JDK17 Spring Boot应用JobRunr定时任务JAXBException排查

核心原因推测 #

虽然你打印的类路径和ClassLoader与Web请求一致，但JobRunr的定时任务执行线程可能使用了不同的线程上下文类加载器，或者JDK17模块化环境下的SPI加载逻辑在JobRunr线程中未正确触发，导致无法找到JAXB实现类。

具体解决方案 #

1. 显式指定JAXBContext的类加载器 #

在创建JAXBContext时，主动传入当前类的类加载器，绕过线程上下文加载器的问题：

try {
    ClassLoader appClassLoader = MrwServiceImpl.class.getClassLoader();
    JAXBContext jc = JAXBContext.newInstance(MrwServiceImpl.class, appClassLoader);
    LOG.error("JAXBContext: {}", jc);
} catch (JAXBException e) {
    LOG.error("Error al crear JAXBContext", e);
}

2. 强制同步JobRunr线程的上下文类加载器 #

自定义JobRunr的JobFilter，确保任务执行时使用Spring Boot的应用类加载器：

@Bean
public JobFilter classLoaderSyncFilter() {
    return new JobFilter() {
        @Override
        public void onCreating(JobFilterContext context) {
            // 保存原线程加载器
            context.metadata().put("originalCL", Thread.currentThread().getContextClassLoader());
            // 替换为应用类加载器
            Thread.currentThread().setContextClassLoader(YourSpringBootApplication.class.getClassLoader());
        }

        @Override
        public void onCompleted(JobFilterContext context) {
            // 恢复原加载器
            ClassLoader originalCL = (ClassLoader) context.metadata().get("originalCL");
            Thread.currentThread().setContextClassLoader(originalCL);
        }
    };
}

将该Filter注册到JobRunr配置中，确保所有定时任务执行前都会同步类加载器。

3. 确保JAXB依赖的完整性与兼容性 #

替换手动添加的JAXB依赖为Spring Boot官方starter，自动适配版本与模块化配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jaxb</artifactId>
</dependency>

如果必须手动指定版本，需确保jaxb-api、jaxb-runtime、jaxb-core版本完全一致，避免SPI加载时出现版本冲突。

4. 显式指定JAXB工厂类（强制SPI加载） #

在Azure应用服务的JVM启动参数中添加：

-Djakarta.xml.bind.JAXBContextFactory=org.glassfish.jaxb.runtime.v2.JAXBContextFactory

直接指定JAXB实现工厂，跳过SPI自动发现的步骤，避免线程上下文类加载器导致的SPI查找失败。

5. 验证JobRunr线程的类加载能力 #

在定时任务中添加日志，确认线程上下文类加载器是否能加载到JAXB实现：

LOG.error("Job Thread Context CL: {}", Thread.currentThread().getContextClassLoader());
try {
    Class<?> jaxbImpl = Class.forName(
        "org.glassfish.jaxb.runtime.v2.runtime.JAXBContextImpl",
        true,
        Thread.currentThread().getContextClassLoader()
    );
    LOG.error("Successfully loaded JAXBImpl: {}", jaxbImpl);
} catch (ClassNotFoundException e) {
    LOG.error("Failed to load JAXBImpl", e);
}

如果日志显示无法加载，说明线程上下文类加载器确实无法访问BOOT-INF/lib下的依赖，此时方案2的类加载器同步是必须的。

内容的提问来源于stack exchange，提问作者Hugo L.M