JDK9 及以上版本适配 wsimport 生成的 SOAP 代码

本文介绍在 JDK9 及以上环境（重点验证 JDK17）下，如何适配 wsimport 生成的 SOAP 客户端代码。主要解决因 JDK 移除 com.sun.xml.internal.* 包导致的编译及运行异常。方案包括配置正确的 Maven 依赖（如 spring-ws-core、jaxws-rt），并通过 System.setProperty 显式指定内部实现类路径以覆盖 SPI 默认加载逻辑，最终实现在 Spring 容器中注入并使用 SOAP 服务。

灭霸发布于 2026/3/29更新于 2026/4/141 浏览

JDK9 及以上版本适配 wsimport 生成的 SOAP 代码

背景

在系统集成场景中，部分遗留系统及第三方服务仍保留 SOAP 接口。尽管 SOAP 协议已逐步被 REST 等轻量级方案替代，但出于兼容性考虑，新系统有时仍需通过 SOAP 协议进行跨系统通信。本文介绍基于 JDK8+ 环境（重点验证 JDK17）的 SOAP 客户端实现方案，解决兼容性问题。

一、`wsimport`自动生成客户端代码

工具简介
wsimport是 JDK8 内置的命令行工具，核心功能为：解析 SOAP 服务的 WSDL 文档，自动生成可直接调用的 Java 客户端代码。生成内容包括：

请求/响应参数的实体类（XML 与 Java 对象映射）
服务接口（Service 类）及实现类
内置 HTTP 通信、XML 序列化/反序列化逻辑

使用命令

wsimport -encoding UTF-8 -s 存放 Java 代码的本地目录 -p 生成代码的包名 -keep 远程 WSDL 地址

示例：

wsimport -encoding UTF-8 -s D:\project\springboot-soap-client\src\main\java -p com.example.soap.client.weather -keep http://www.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl

二、JDK9+（JDK17）适配 wsimport 生成的代码

核心问题
wsimport 生成的类里会包含 javax.xml.bind.annotation.、javax.jws.、javax.xml.ws.*等引用，然而，2019 年 Oracle 将 JavaEE 捐赠给 Eclipse 基金会，Eclipse 将其重命名为 Jakarta EE，并且将所有 API 的包名做了「一刀切」迁移：所有 javax.xxx 全部改为 jakarta.xxx，这就很恶心了。因为一旦引用错误，比如用 3.0.x 的 jakarta 版本会出现包名冲突，反而出问题，使得编译失败！

依赖管理策略
需严格匹配 Jakarta EE 版本与 JDK 兼容性，推荐使用经过验证的依赖组合（以 Maven 为例）：

<!-- Spring WebServices 核心：必须加！提供 WebServiceTemplate 和 JAXB2Marshaller -->
<dependency>
    <groupId>org.springframework.ws</groupId>
    <artifactId>spring-ws-core</artifactId>
    <version>2.3.1.RELEASE</version>
    <exclusions>
        <exclusion>
            <>commons-logging
            commons-logging
        
    



    javax.jws
    javax.jws-api
    1.1



    javax.xml.ws
    jaxws-api
    2.3.1



    com.sun.xml.ws
    jaxws-rt
    2.1.3
    
        
        
            javax.xml.ws
            jaxws-api
        
        
            javax.activation
            activation
        
        
            javax.xml.soap
            saaj-api
        
        
            javax.xml.stream
            stax-api

相关免费在线工具

Keycode 信息

查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online

Escape 与 Native 编解码

JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online

JavaScript / HTML 格式化

使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online

JavaScript 压缩与混淆

Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online

Base64 字符串编码/解码

将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online

Base64 文件转换器

将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

@Configuration public class WebServiceConfig { // ============ 核心：JDK17 一站式修正所有 com.sun.xml.internal.* → com.sun.xml.* 路径 ============ static { // 1. 修复 JAX-WS ProviderImpl 路径：internal 移除 System.setProperty("javax.xml.ws.spi.Provider", "com.sun.xml.ws.spi.ProviderImpl"); // 2. 修复 JAXB ContextFactory 路径：internal 移除 System.setProperty("javax.xml.bind.context.factory", "com.sun.xml.bind.v2.ContextFactory"); // 3. 修复 SAAJ MetaFactoryImpl 路径：internal 移除【解决你当前的新报错核心配置】 System.setProperty("javax.xml.soap.MetaFactory", "com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl"); // 4. 修复 SAAJ MessageFactory 路径：internal 移除 System.setProperty("javax.xml.soap.MessageFactory", "com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl"); // 5. 修复 SAAJ SOAPFactory 路径：internal 移除 System.setProperty("javax.xml.soap.SOAPFactory", "com.sun.xml.messaging.saaj.soap.ver1_1.SOAPFactory1_1Impl"); } /** * 注册 ServiceSoap 代理 Bean 到 Spring 容器 */ @Bean public ServiceSoap xxxServiceSoap() { try { URL wsdlUrl = new URL("https://你的 WSDL 地址？wsdl"); Service service = new Service(wsdlUrl); ServiceSoap serviceSoap = service.getServiceSoap(); BindingProvider bindingProvider = (BindingProvider) serviceSoap; // 获取请求上下文 Map<String, Object> requestContext = bindingProvider.getRequestContext(); // 防止请求发送到的 URL 地址不对问题 requestContext.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, "https://你的 WSDL 地址"); // 设置连接超时（单位：毫秒） requestContext.put(BindingProviderProperties.CONNECT_TIMEOUT, 5000); // 设置读取超时（单位：毫秒） requestContext.put(BindingProviderProperties.REQUEST_TIMEOUT, 10000); Map<String, List<String>> headers = new HashMap<>(); // 防止 Unsupported Content-Type: text/html Supported ones are: [text/xml] 错误 headers.put("Content-Type", Collections.singletonList("text/xml;charset=UTF-8")); bindingProvider.getRequestContext().put(MessageContext.HTTP_REQUEST_HEADERS, headers); return serviceSoap; } catch (Exception e) { throw new RuntimeException("初始化 ServiceSoap 失败", e); } } }

JDK9 及以上版本适配 wsimport 生成的 SOAP 代码