升级cxf-codegen-plugin至4.0.0后WSDLServiceBuilder警告的影响与解决

将cxf-codegen-plugin从3.5.3版本升级至4.0.0版本后，出现如下警告：

[WARNING] mars 09, 2023 10:17:25 FM org.apache.cxf.wsdl11.WSDLServiceBuilder checkForWrapped
[WARNING] INFO: Operation {http://soa.jboss.org/print}sendEmail-2.0Op cannot be unwrapped, input message must reference global element declaration with same localname as operation

对应的WSDL代码片段：

<wsdl:message name="sendEmail-2.0Res">
    <wsdl:part element="esbns2:sendEmailResponse" name="out">
    </wsdl:part>
</wsdl:message>
<wsdl:message name="sendEmail-2.0Fault1">
    <wsdl:part element="esbns3:fikFault" name="fault1">
    </wsdl:part>
</wsdl:message>
<wsdl:message name="sendEmail-2.0Req">
    <wsdl:part element="esbns1:sendEmailRequest" name="in">
    </wsdl:part>
</wsdl:message>
<wsdl:portType name="sendEmail-2.0PortType">
    <wsdl:operation name="sendEmail-2.0Op">
        <wsdl:input message="tns:sendEmail-2.0Req" name="sendEmail-2.0Req">
        </wsdl:input>
        <wsdl:output message="tns:sendEmail-2.0Res" name="sendEmail-2.0Res">
        </wsdl:output>
        <wsdl:fault message="tns:sendEmail-2.0Fault1" name="fault1">
        </wsdl:fault>
    </wsdl:operation>
</wsdl:portType>
<wsdl:binding name="sendEmail-2.0Binding" type="tns:sendEmail-2.0PortType">
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    <wsdl:operation name="sendEmail-2.0Op">
        <soap:operation soapAction="http://soa.jboss.org/sendEmail-2.0/sendEmail-2.0OpResp"/>
        <wsdl:input name="sendEmail-2.0Req">
            <soap:body use="literal"/>
        </wsdl:input>
        <wsdl:output name="sendEmail-2.0Res">
            <soap:body use="literal"/>
        </wsdl:output>
        <wsdl:fault name="fault1">
            <soap:fault name="fault1" use="literal"/>
        </wsdl:fault>
    </wsdl:operation>
</wsdl:binding>
<wsdl:service name="sendEmail-2.0Service">
    <wsdl:port binding="tns:sendEmail-2.0Binding" name="sendEmail-2.0PortType">
        <soap:address location="url"/>
    </wsdl:port>
</wsdl:service>

警告的影响 #

• 该警告不会直接导致服务无法启动或调用失败，代码生成和基础服务功能可正常运行。
• 核心限制是CXF无法对该操作启用**文档/未封装（Document/Unwrapped）样式优化：未封装样式会将消息根元素直接作为方法参数/返回值，简化代码调用；现在只能使用文档/封装（Document/Wrapped）**样式，生成的代码会多一层封装类（例如sendEmail-2.0Op方法的参数是包含sendEmailRequest的封装对象，而非直接传入sendEmailRequest实例）。
• 若后续代码依赖未封装样式的逻辑（如自定义拦截器、参数映射规则），可能出现适配异常。

解决方法 #

警告根源是CXF 4.0.0对Document/Unwrapped样式的校验更严格：要求操作名称与输入消息引用的全局元素本地名称完全一致。有两种解决路径：

方式一：修改WSDL符合规范 #

调整操作名称或全局元素名称，使二者本地名称一致。例如：
将操作名改为与输入元素sendEmailRequest匹配：

<wsdl:operation name="sendEmailRequest">
    <wsdl:input message="tns:sendEmail-2.0Req" name="sendEmail-2.0Req">
    </wsdl:input>
    <wsdl:output message="tns:sendEmail-2.0Res" name="sendEmail-2.0Res">
    </wsdl:output>
    <wsdl:fault message="tns:sendEmail-2.0Fault1" name="fault1">
    </wsdl:fault>
</wsdl:operation>

注意：修改WSDL可能影响现有客户端兼容性，需评估后执行。

方式二：强制关闭Unwrapped检测 #

若不想修改WSDL，可在cxf-codegen-plugin配置中添加参数，强制使用Wrapped样式，跳过Unwrapped校验：
在插件的<configuration>节点内添加：

<defaultOptions>
    <extraargs>
        <extraarg>-noUnwrapping</extraarg>
    </extraargs>
</defaultOptions>

配置后CXF将直接生成Wrapped样式的代码，不再触发该警告。

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