收到SIGTERM命令后异步方法中SOAP服务无法运行求助

从错误栈可以明确：应用优雅关闭过程中，Tomcat的Web应用类加载器已被标记为停止状态，但异步线程仍在执行SOAP调用，此时尝试加载META-INF/services/javax.xml.bind.JAXBContext资源时，被类加载器的状态检查拦截。

核心原因：

• 你配置的优雅关闭参数确实会等待异步线程完成，但SOAP客户端的JAXBContext可能是第一次在关闭阶段的异步任务中触发初始化，此时WebappClassLoader已停止，无法加载资源
• Tomcat的WebappClassLoaderBase在应用停止后会拒绝任何资源加载请求，防止非法访问已卸载的Web应用

1. 提前初始化SOAP客户端的JAXBContext #

在应用启动阶段提前触发JAXBContext初始化，避免在关闭阶段触发类加载：

@Component
public class SoapClientInitializer implements ApplicationListener<ApplicationReadyEvent> {
    @Autowired
    private YourSoapClient soapClient;

    @Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
        // 提前触发JAXBContext初始化
        soapClient.preInitializeJaxb();
    }
}

在你的SOAP客户端中添加初始化方法：

public class YourSoapClient {
    public void preInitializeJaxb() {
        try {
            // 直接初始化对应SOAP实体类的JAXBContext
            JAXBContext.newInstance(YourSoapRequest.class, YourSoapResponse.class);
        } catch (JAXBException e) {
            log.error("JAXBContext初始化失败", e);
        }
    }
}

2. 为异步线程池指定固定类加载器 #

避免异步线程使用已停止的WebappClassLoader，在配置线程池时显式设置上下文类加载器：

ThreadPoolTaskExecutor defaultExecutor = new ThreadPoolTaskExecutor();
defaultExecutor.setKeepAliveSeconds(180);
defaultExecutor.setWaitForTasksToCompleteOnShutdown(true);
defaultExecutor.setAwaitTerminationSeconds(180);

// 为线程指定应用启动时的类加载器
defaultExecutor.setThreadFactory(runnable -> {
    Thread thread = new Thread(runnable);
    thread.setContextClassLoader(YourApplication.class.getClassLoader());
    thread.setName("h2h-async-" + thread.getId());
    return thread;
});

3. 调整Bean销毁顺序 #

确保异步线程池完全终止后，再销毁SOAP客户端相关Bean，可通过SmartLifecycle接口实现：

@Component
public class AsyncPoolLifecycle implements SmartLifecycle {
    private boolean running = false;
    @Autowired
    private ThreadPoolTaskExecutor taskExecutor;

    @Override
    public void start() {
        running = true;
    }

    @Override
    public void stop() {
        // 等待线程池终止
        taskExecutor.shutdown();
        try {
            if (!taskExecutor.awaitTermination(3, TimeUnit.MINUTES)) {
                taskExecutor.shutdownNow();
            }
        } catch (InterruptedException e) {
            taskExecutor.shutdownNow();
            Thread.currentThread().interrupt();
        }
        running = false;
    }

    @Override
    public boolean isRunning() {
        return running;
    }
}

4. 升级依赖版本 #

你当前使用的JAX-WS（2.3.1）和JAXB（2.4.0）版本较旧，升级到兼容Spring Boot当前版本的稳定版，可修复部分类加载相关问题：
例如Spring Boot 2.7.x可使用：

• jaxws-rt:2.3.5
• jaxb-api:2.3.1
• jaxb-impl:2.3.5

应用启动后先触发一次SOAP调用，确认JAXBContext已完成初始化；发送SIGTERM信号，观察异步线程是否能正常完成SOAP调用且无类加载异常。

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