JAX-WS wsimport未保留ONVIF WSDL大写操作名问题

核心问题 #

JAX-WS默认会将WSDL中大写开头的操作名（如GetDeviceInformation）转换为Java驼峰命名（首字母小写的getDeviceInformation），但ONVIF的SOAP服务要求严格匹配原始操作名，导致大写请求触发500错误。

方法1：通过绑定自定义文件强制保留原始操作名 #

这是最稳定的解决方案，通过外部绑定文件覆盖JAX-WS的默认命名策略。

1. 创建绑定文件 binding.xml

根据你使用的是Java EE（javax）还是Jakarta EE版本，选择对应命名空间：

<!-- Jakarta EE 3.x/4.x 版本 -->
<jaxws:bindings xmlns:jaxws="https://jakarta.ee/xml/ns/jaxws"
                xmlns:jaxb="https://jakarta.ee/xml/ns/jaxb"
                xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
                version="3.0">
    <!-- 全局关闭Java命名约定转换 -->
    <jaxws:enableJavaNamingConventions>false</jaxws:enableJavaNamingConventions>
    
    <!-- 针对单个操作明确指定方法名（可选，全局配置失效时补充） -->
    <jaxws:bindings wsdlLocation="path/to/your/onvif-device.wsdl" node="wsdl:definitions/wsdl:portType[@name='Device']/wsdl:operation[@name='GetDeviceInformation']">
        <jaxws:method name="GetDeviceInformation"/>
    </jaxws:bindings>
    <jaxws:bindings wsdlLocation="path/to/your/onvif-device.wsdl" node="wsdl:definitions/wsdl:portType[@name='Device']/wsdl:operation[@name='GetServices']">
        <jaxws:method name="GetServices"/>
    </jaxws:bindings>
    <jaxws:bindings wsdlLocation="path/to/your/onvif-device.wsdl" node="wsdl:definitions/wsdl:portType[@name='Device']/wsdl:operation[@name='GetServiceCapabilities']">
        <jaxws:method name="GetServiceCapabilities"/>
    </jaxws:bindings>
</jaxws:bindings>

如果是Java EE（javax）版本，将命名空间替换为http://java.sun.com/xml/ns/jaxws和http://java.sun.com/xml/ns/jaxb。

2. 在Maven插件中配置绑定文件

修改pom.xml中的jaxws-maven-plugin，引入绑定文件：

<plugin>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-maven-plugin</artifactId>
    <version>4.0.0</version> <!-- 对应Jakarta 4.x，Java EE用2.3.5 -->
    <executions>
        <execution>
            <goals>
                <goal>wsimport</goal>
            </goals>
            <configuration>
                <wsdlFiles>
                    <wsdlFile>src/main/resources/onvif-device.wsdl</wsdlFile>
                </wsdlFiles>
                <bindingFiles>
                    <bindingFile>src/main/resources/binding.xml</bindingFile>
                </bindingFiles>
                <packageName>com.your.package.onvif</packageName>
                <extension>true</extension>
            </configuration>
        </execution>
    </executions>
    <!-- Jakarta版本需添加依赖 -->
    <dependencies>
        <dependency>
            <groupId>jakarta.xml.ws</groupId>
            <artifactId>jakarta.xml.ws-api</artifactId>
            <version>4.0.0</version>
        </dependency>
    </dependencies>
</plugin>

方法2：手动修改生成代码（应急方案） #

如果绑定文件配置未生效，可临时修改生成的Java接口：
将自动生成的小写方法名改为大写，并确保@WebMethod的operationName与WSDL一致：

// 修改前
@WebMethod(operationName = "GetDeviceInformation")
public GetDeviceInformationResponse getDeviceInformation(GetDeviceInformation parameters);

// 修改后
@WebMethod(operationName = "GetDeviceInformation")
public GetDeviceInformationResponse GetDeviceInformation(GetDeviceInformation parameters);

注意：此方法每次重新生成代码都会被覆盖，仅适合临时测试。

常见坑点说明 #

• 直接在WSDL内添加enableJavaNamingConventions="false"优先级较低，容易被JAX-WS忽略，建议使用外部绑定文件。
• Jakarta版本必须使用对应的命名空间，否则配置不生效。

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