Java17+Jakarta EE生成SOAP Client：enableWrapperStyle配置无效仍生成Holder类

针对设置<enableWrapperStyle>true</enableWrapperStyle>后仍生成Holder类型参数的问题，可从以下方向排查解决：

1. 确保绑定文件针对具体WSDL元素生效 #

全局设置enableWrapperStyle可能未被正确关联到目标WSDL的portType或操作，需修改绑定文件明确指定要定制的WSDL组件：

修改bindings.xml：

<bindings xmlns="https://jakarta.ee/xml/ns/jaxws"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
          xsi:schemaLocation="https://jakarta.ee/xml/ns/jaxws
                      https://jakarta.ee/xml/ns/jaxws/wsdl_customizationschema_3_0.xsd"
          version="3.0">
    <!-- 关联你的WSDL文件 -->
    <bindings wsdlLocation="myService.wsdl">
        <!-- 替换为你WSDL中的portType名称 -->
        <bindings node="wsdl:definitions/wsdl:portType[@name='YourTargetPortType']">
            <enableWrapperStyle>true</enableWrapperStyle>
        </bindings>
    </bindings>
</bindings>

2. 检查WSDL的操作风格适配性 #

enableWrapperStyle仅对document/literal wrapped风格的WSDL生效。若你的WSDL是RPC风格或document/literal bare，需确认WSDL的binding配置符合规范：

<binding name="YourServiceBinding" type="tns:YourTargetPortType">
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="YourOperation">
        <soap:operation soapAction=""/>
        <input>
            <soap:body use="literal"/>
        </input>
        <output>
            <soap:body use="literal"/>
        </output>
    </operation>
</binding>

3. 处理Out/InOut类型参数的Holder生成 #

Holder类型通常对应WSDL中的out或inout参数，即使启用Wrapper Style，这类参数默认仍会生成Holder。若要将其包装到响应对象中，需在绑定文件中针对具体操作参数配置：

<bindings xmlns="https://jakarta.ee/xml/ns/jaxws"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
          xsi:schemaLocation="https://jakarta.ee/xml/ns/jaxws
                      https://jakarta.ee/xml/ns/jaxws/wsdl_customizationschema_3_0.xsd"
          version="3.0">
    <bindings wsdlLocation="myService.wsdl">
        <bindings node="wsdl:definitions/wsdl:portType[@name='YourTargetPortType']/wsdl:operation[@name='YourOperation']">
            <enableWrapperStyle>true</enableWrapperStyle>
            <!-- 替换为你的参数名和期望的包装类 -->
            <parameter part="parameters" name="OutParamName" mode="OUT">
                <javaType name="com.company.myService.YourOperationResponse" />
            </parameter>
        </bindings>
    </bindings>
</bindings>

4. 验证绑定文件是否被Maven插件正确加载 #

运行Maven时添加调试参数，确认绑定文件是否被读取：

mvn clean install -X

在日志中查找类似如下的信息，若未找到则检查bindingDirectory和bindingFile路径是否正确：

[INFO] Processing binding file: src/main/resources/wsdl/bindings.xml

5. 升级Maven插件版本 #

若使用的jaxws-maven-plugin 4.0.0存在已知bug，尝试升级到最新稳定版本（如4.0.1及以上），修改插件配置中的版本号即可。

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