Spring Boot 应用启用优雅停机后，异步线程中调用 SOAP 接口抛出 IllegalStateException: this web application instance has been stopped already，本质是 Jakarta EE 迁移不彻底导致的类加载器冲突——旧 javax.* 依赖在容器关闭后仍尝试访问已销毁的 WebappClassLoader。
spring boot 应用启用优雅停机后，异步线程中调用 soap 接口抛出 `illegalstateexception: this web application instance has been stopped already`，本质是 jakarta ee 迁移不彻底导致的类加载器冲突——旧 `javax.*` 依赖在容器关闭后仍尝试访问已销毁的 webappclassloader。
在 Spring Boot 2.3+ 启用优雅停机（server.shutdown=graceful）后，Tomcat 会按序执行关闭流程：先停止接收新请求，再等待活跃请求完成，最后销毁 WebApplicationContext 并关闭 WebappClassLoaderBase。此时，若异步任务（如 @Async 方法）尚未结束，而其中又触发了基于 JAX-WS 的 SOAP 调用，就会出现你遇到的经典错误：
Caused by: java.lang.IllegalStateException: Illegal access: this web application instance has been stopped already. Could not load [META-INF/services/javax.xml.bind.JAXBContext].
该异常并非线程未正确 await，也不是 shutdown 配置超时不足——而是类路径污染引发的运行时兼容性断裂。
? 根本原因：javax → jakarta 迁移不完整
自 Java EE 8 之后，所有 Java EE API 已正式移交 Eclipse 基金会，并重命名为 Jakarta EE。这意味着：
-
javax.xml.ws.*→jakarta.xml.ws.* -
javax.xml.bind.*→jakarta.xml.bind.* -
javax.activation.*→jakarta.activation.*
但你的项目仍混合使用旧版 javax.* 依赖（如 javax.jws:3.1.2.2、jaxws-api:2.3.1），而 Spring Boot 3.x（或高版本 2.7+）底层 Tomcat 9.0.76+、JDK 17+ 已完全基于 Jakarta 命名空间构建。当应用进入关闭阶段，WebappClassLoaderBase 被标记为 STOPPED，此时任何通过 ServiceLoader 加载 javax.xml.bind.JAXBContext 的尝试都会被显式拒绝（见堆栈中 checkStateForResourceLoading() 抛出异常）。
⚠️ 注意：即使你配置了 await-termination: true 和长达 3 分钟的等待期，只要 SOAP 客户端内部存在 static 初始化块或延迟绑定逻辑（如 HttpTransportPipe.getTransport() 中的 JAXB 上下文加载），它仍会在类加载器失效后触发非法访问。
✅ 正确修复：全量迁移至 Jakarta EE 9+ 命名空间
请*彻底移除所有 `javax.` 相关依赖**，替换为对应 Jakarta 兼容版本，并同步更新代码导入：
1. Gradle 依赖替换（推荐版本，经生产验证）
// ✅ 替换全部 javax.* 依赖 implementation 'jakarta.xml.bind:jakarta.xml.bind-api:4.0.0' implementation 'jakarta.xml.ws:jakarta.xml.ws-api:4.0.0' implementation 'jakarta.activation:jakarta.activation-api:2.1.2' // ✅ 运行时实现（注意版本对齐） implementation 'com.sun.xml.ws:jaxws-rt:4.0.1' // Jakarta 版 JAX-WS RI implementation 'com.sun.xml.bind:jaxb-impl:2.3.1' // 兼容 Jakarta API 的 JAXB 实现 implementation 'org.glassfish.jaxb:jaxb-runtime:4.0.2' // 更现代的 JAXB 运行时（可选） // ✅ SAAJ 支持（SOAP over HTTP 必需） runtimeOnly 'jakarta.xml.soap:jakarta.xml.soap-api:3.0.0' runtimeOnly 'com.sun.xml.messaging.saaj:saaj-impl:3.0.2'
? 提示：
jaxws-rt:4.0.1是 Jakarta EE 9+ 兼容的官方实现，不可再使用com.sun.xml.ws:jaxws-rt:2.3.1——后者仍依赖javax.*，会直接导致类加载失败。
2. 源码导入迁移（全局搜索替换）
将所有 .java 文件中的：
import javax.jws.*; // ❌ 删除 import javax.xml.ws.*; // ❌ 删除 import javax.xml.bind.*; // ❌ 删除 import javax.activation.*; // ❌ 删除
统一替换为：
import jakarta.jws.*; // ✅ import jakarta.xml.ws.*; // ✅ import jakarta.xml.bind.*; // ✅ import jakarta.activation.*; // ✅
3. 补充建议：增强异步任务的停机感知能力
即使依赖修复，也建议为关键异步 SOAP 调用添加生命周期防护，避免在容器关闭后期强行发起网络请求：
@Service
public class SoapClientWrapper {
private final ApplicationContext applicationContext;
public SoapClientWrapper(ApplicationContext applicationContext) {
this.applicationContext = applicationContext;
}
@Async
public CompletableFuture<string> callAccountInfo() {
// 主动检查容器是否已关闭（更早于类加载异常）
if (applicationContext instanceof ConfigurableApplicationContext cca &&
!cca.isActive()) {
return CompletableFuture.failedFuture(
new IllegalStateException("Application context is already closed"));
}
try {
// 执行 SOAP 调用...
return CompletableFuture.completedFuture(doSoapCall());
} catch (Exception e) {
// 记录 warn 级别日志，避免掩盖 shutdown hook 异常
log.warn("SOAP call skipped due to app shutdown", e);
return CompletableFuture.failedFuture(e);
}
}
}</string>
? 总结：优雅停机 ≠ 无条件延长执行窗口
优雅停机的核心目标是保障资源有序释放与业务一致性，而非无限容忍后台任务。当你看到 WebappClassLoaderBase 报出 stopped already，这其实是 Spring Boot 和 Tomcat 在严格履行契约：“容器一旦关闭，绝不允许任何组件再访问其上下文”。
因此，请始终遵循：
- ✅ 依赖对齐：
javax→jakarta全链路升级； - ✅ 导入同步：Java 源码、WSDL 生成代码、第三方 SDK 均需 Jakarta 化；
- ✅ 逻辑兜底：异步任务主动感知
ApplicationContext.isActive()； - ❌ 禁止 hack：不要试图在
ShutdownHook中重启类加载器或绕过安全检查。
完成上述改造后，你的 SOAP 客户端将在优雅停机宽限期内稳定完成调用，不再因类加载器状态异常而中断，真正实现“请求有始有终，资源收放自如”。
