使用wsimport解析HTTPS暴露的WSDL生成代码报protocol_version错误如何解决
Apache Geronimo WSDL代码生成报错解决方案
原始运行报错信息:
parsing WSDL...
[ERROR] Received fatal alert: protocol_version
无法读取WSDL文档https://devurl:7443/process-engine/soap/CustomerByNumber_v1?wsdl,原因可能为:1) 无法找到该文档;2) 文档无法读取;3) 文档根元素不是wsdl:definitions。
[ERROR] failed.noservice=在提供的WSDL中找不到wsdl:service:
至少需要提供一个包含至少一个service定义的WSDL。
WSDL解析失败。
报错根因说明
两个核心问题导致执行失败:
- 客户端与服务端TLS协议版本不匹配,触发
protocol_version报错 - 未提供WSDL访问所需的用户名密码,无法正常拉取WSDL内容,因此后续找不到
wsdl:service定义
分步解决方法
1. 适配TLS协议版本
给wsimport命令添加JVM参数指定TLS版本,匹配服务端要求的协议版本(通常为TLSv1.2或TLSv1.3),参数格式为-J-Dhttps.protocols=TLSv1.2。
2. 配置WSDL访问认证
两种方案可选:
- 方案1:直接在WSDL URL中带入认证信息
注意:用户名和密码如果包含@、:、/等特殊字符,需要先做URL编码后再填入
示例命令:wsimport -J-Dhttps.protocols=TLSv1.2 -keep -verbose https://你的用户名:你的密码@devurl:7443/process-engine/soap/CustomerByNumber_v1?wsdl - 方案2:先下载WSDL到本地再生成代码(推荐,避免明文暴露密码、减少网络依赖)
第一步:用curl拉取WSDL文件到本地:
第二步:用本地WSDL文件执行代码生成:curl -u 你的用户名:你的密码 https://devurl:7443/process-engine/soap/CustomerByNumber_v1?wsdl -o CustomerByNumber_v1.wsdlwsimport -keep -verbose ./CustomerByNumber_v1.wsdl
3. 仍提示找不到wsdl:service的处理
如果服务端返回的WSDL本身没有预定义service节点,可在本地下载的WSDL文件末尾</wsdl:definitions>标签之前添加自定义service配置:
<wsdl:service name="CustomerByNumber_v1Service"> <wsdl:port name="CustomerByNumber_v1Port" binding="tns:CustomerByNumber_v1Binding"> <soap:address location="https://devurl:7443/process-engine/soap/CustomerByNumber_v1"/> </wsdl:port> </wsdl:service>
保存后重新执行本地WSDL生成命令即可。
内容的提问来源于stack exchange,提问作者Joy
相关产品推荐
相关产品推荐

