Java项目调用SOAP服务时WSDL字段名与请求不一致问题

看起来你遇到了CXF代码生成插件在处理WSDL时的字段名映射问题——这种情况通常是JAXB默认的命名转换规则在搞鬼，或者是绑定配置没到位。下面给你几个针对性的解决方案：

1. 自定义JAXB绑定文件强制保留WSDL字段名 #

CXF底层依赖JAXB做XML与Java类的绑定，默认会把WSDL里的驼峰式字段（比如Comment）转成Java风格的小写开头（comment），反过来序列化SOAP请求时就会用小写开头的字段名，和WSDL定义不符。

你可以创建一个JAXB绑定文件（比如jaxb-binding.xml）来覆盖默认规则：

<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               version="2.1">
    <!-- 全局配置：禁用默认的命名转换，保留WSDL原始字段名 -->
    <jaxb:globalBindings>
        <jaxb:nameXmlTransform>
            <jaxb:elementName suffix="" prefix="" />
            <jaxb:propertyName suffix="" prefix="" />
        </jaxb:nameXmlTransform>
    </jaxb:globalBindings>

    <!-- 针对HitOffers类型做精准绑定（可选，全局配置生效的话可以省略） -->
    <jaxb:bindings schemaLocation="你的WSDL文件路径" node="/xsd:schema">
        <jaxb:bindings node="xsd:complexType[@name='HitOffers']">
            <jaxb:bindings node="xsd:sequence/xsd:element[@name='Comment']">
                <jaxb:property name="Comment"/>
            </jaxb:bindings>
            <jaxb:bindings node="xsd:sequence/xsd:element[@name='Offers']">
                <jaxb:property name="Offers"/>
            </jaxb:bindings>
        </jaxb:bindings>
    </jaxb:bindings>
</jaxb:bindings>

然后在Maven的cxf-codegen-plugin配置中引入这个绑定文件：

<plugin>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-codegen-plugin</artifactId>
    <version>3.1.6</version>
    <executions>
        <execution>
            <id>generate-soap-sources</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>wsdl2java</goal>
            </goals>
            <configuration>
                <wsdlOptions>
                    <wsdlOption>
                        <wsdl>src/main/resources/你的WSDL文件.wsdl</wsdl>
                        <bindingFiles>
                            <bindingFile>src/main/resources/jaxb-binding.xml</bindingFile>
                        </bindingFiles>
                    </wsdlOption>
                </wsdlOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

2. 检查生成代码的@XmlElement注解 #

重新生成代码后，打开HitOffers类，查看字段对应的@XmlElement注解：

// 错误示例：name属性是小写的comment
@XmlElement(name = "comment")
protected String comment;

// 正确示例：name属性要和WSDL一致
@XmlElement(name = "Comment", nillable = true)
protected String Comment;

如果注解里的name和WSDL字段名不符，要么是绑定文件没生效，要么是需要调整绑定规则。注意：不要手动修改生成的代码，下次生成会被覆盖，一定要用绑定文件来固化规则。

3. 排查命名空间问题 #

如果WSDL里的字段带有命名空间前缀（比如tns:Comment），要确保绑定文件里的schemaLocation和node路径正确指向WSDL的schema定义，避免生成的代码遗漏命名空间，导致请求字段名异常。

4. 尝试升级CXF版本 #

你当前使用的3.1.6版本比较老旧，可能存在一些JAXB绑定的已知bug。如果上面的方法都无效，可以尝试升级到CXF 3.5.x系列（兼容Java 8+），新版本对WSDL的字段映射处理更稳定。

最后，建议你开启CXF的日志拦截器，查看实际发送的SOAP请求内容，确认字段名是否和WSDL一致：

Client client = ClientProxy.getClient(yourSoapPort);
client.getOutInterceptors().add(new LoggingOutInterceptor());

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