从WSDL生成SOAP API客户端代码时遇无效WSDL报错求助

问题背景 #

• 需求：基于GetListingInteraction_1.0_rivtabp20.wsdl生成SOAP API客户端，该WSDL依赖crm_carelisting_1_0.xsd、GetListing_1_0.xsd和ws-addressing-1.0.xsd三个文件
• 技术栈：Kotlin + Java 11，使用com.yupzip.wsdl2java Gradle插件
• 报错信息：Failed to create java parameter for part [logicalAddress] in method [getListing] - this wsdl is invalid, please use the wsdlvalidator tool to validate this wsdl
• 异常特征：同配置下其他SOAP API可正常生成代码，自行校验WSDL未发现语法问题

诊断分析 #

该报错核心原因是com.yupzip.wsdl2java插件对WS-Addressing规范中EndpointReferenceType类型的logicalAddress参数处理逻辑存在兼容性问题。对比可正常生成的WSDL，这类WSDL通常未引入带扩展属性的WS-Addressing绑定，而当前WSDL中的logicalAddress属于WS-Addressing的复杂类型，插件默认规则无法将其映射为合法的Java参数。

解决方案 #

方案1：添加WS-Addressing绑定配置 #

在Gradle任务中指定自定义绑定文件，强制插件正确识别WS-Addressing类型：

1. 在资源目录下创建ws-addressing-binding.xml，内容如下：

<jaxws:bindings xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
               xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:wsa="http://www.w3.org/2005/08/addressing"
               version="2.0">
    <jaxb:bindings schemaLocation="ws-addressing-1.0.xsd" node="/xs:schema">
        <jaxb:globalBindings>
            <jaxb:javaType name="java.net.URI" xmlType="wsa:AttributedURI"
                           parseMethod="java.net.URI.create"
                           printMethod="toString"/>
        </jaxb:globalBindings>
    </jaxb:bindings>
</jaxws:bindings>

2. 修改Gradle配置，引入绑定文件：

wsdl2java {
    wsdlsToGenerate = [
            ['-p', 'com.example.wsdl', 'src/main/resources/GetListingInteraction_1.0_rivtabp20.wsdl']
    ]
    bindingFiles = ['src/main/resources/ws-addressing-binding.xml']
}

方案2：替换为Apache CXF官方插件 #

若com.yupzip插件对WS-Addressing支持不足，改用Apache CXF的代码生成插件，其对复杂WSDL兼容性更好：

1. 在build.gradle.kts中添加插件依赖：

plugins {
    id("java")
    id("org.jetbrains.kotlin.jvm") version "1.9.20"
    id("io.mateo.cxf-codegen") version "2.0.1"
}

2. 配置代码生成任务：

cxfCodeGen {
    wsdlToJava {
        setWsdl(file("src/main/resources/GetListingInteraction_1.0_rivtabp20.wsdl"))
        packageName.set("com.example.wsdl")
        extraArgs.addAll(listOf("-xjc-Xwsdl", "-verbose"))
    }
}

3. 执行cxfCodeGenWsdlToJava任务生成客户端代码。

方案3：临时修改WSDL（仅测试用） #

若需快速验证API逻辑，可临时修改WSDL，将logicalAddress参数替换为插件可识别的简单类型（如string），生成代码后再手动调整客户端逻辑适配原WSDL规范（生产环境不推荐）。

验证 #

采用方案1或2后，重新执行Gradle代码生成任务，即可成功生成无报错的SOAP客户端代码，且可正常调用目标API。

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