Spring Boot3+Java17下jaxws-maven-plugin绑定文件识别失败求助

直接可用的修复方案 #

1. 调整绑定文件结构与命名空间 #

原绑定文件仅适配JAXB，jaxws-maven-plugin 4.x（适配Jakarta EE）要求绑定文件同时兼容JAX-WS规范，修改后的bindings.xml如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<jaxws:bindings xmlns:jaxws="http://jakarta.ee/xml/ns/jaxws"
                xmlns:jaxb="http://jakarta.ee/xml/ns/jaxb"
                xmlns:xs="http://www.w3.org/2001/XMLSchema"
                xmlns:xjc="http://jakarta.ee/xml/ns/jaxb/xjc"
                jaxb:extensionBindingPrefixes="xjc"
                jaxb:version="3.0">
    <!-- 绑定到目标WSDL内部的schema节点 -->
    <jaxws:bindings wsdlLocation="HelloWorldService.wsdl" node="wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='http://example.com/helloworld']">
        <!-- 映射xsd日期类型到java.time包下的类 -->
        <jaxb:javaType name="java.time.LocalDate"
                       xmlType="xs:date"
                       parseMethod="java.time.LocalDate.parse"
                       printMethod="java.time.LocalDate.toString"/>
        <jaxb:javaType name="java.time.LocalTime"
                       xmlType="xs:time"
                       parseMethod="java.time.LocalTime.parse"
                       printMethod="java.time.LocalTime.toString"/>
        <jaxb:javaType name="java.time.LocalDateTime"
                       xmlType="xs:dateTime"
                       parseMethod="java.time.LocalDateTime.parse"
                       printMethod="java.time.LocalDateTime.toString"/>
    </jaxws:bindings>
</jaxws:bindings>

2. 完善插件配置 #

明确指定WSDL和绑定文件路径，同时补充Jakarta相关依赖确保兼容性：

<plugin>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-maven-plugin</artifactId>
    <version>4.0.1</version>
    <executions>
        <execution>
            <id>generate-sources</id>
            <phase>generate-sources</phase>
            <goals>
                <goal>wsimport</goal>
            </goals>
            <configuration>
                <xdebug>true</xdebug>
                <verbose>true</verbose>
                <!-- 指定WSDL文件路径，需与项目结构对应 -->
                <wsdlFiles>
                    <wsdlFile>HelloWorldService.wsdl</wsdlFile>
                </wsdlFiles>
                <!-- 指定绑定文件 -->
                <bindingFiles>
                    <bindingFile>bindings.xml</bindingFile>
                </bindingFiles>
            </configuration>
        </execution>
    </executions>
    <configuration>
        <packageName>com.daimler.daivb.cat.pkimgmt.bl.internal</packageName>
        <verbose>true</verbose>
        <xdebug>true</xdebug>
    </configuration>
    <!-- 补充Jakarta JAXB依赖，避免版本冲突 -->
    <dependencies>
        <dependency>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
            <version>3.0.1</version>
        </dependency>
        <dependency>
            <groupId>com.sun.xml.bind</groupId>
            <artifactId>jaxb-impl</artifactId>
            <version>3.0.2</version>
            <scope>runtime</scope>
        </dependency>
    </dependencies>
</plugin>

失败原因解析 #

1. 命名空间不兼容：Spring Boot3基于Jakarta EE替代原Java EE，绑定文件必须引入jaxws命名空间（http://jakarta.ee/xml/ns/jaxws），否则插件会判定这不是合法的JAX-WS绑定文件。
2. 绑定目标模糊：原绑定文件直接绑定到全局JAXB schema，未关联到具体WSDL中的schema节点，插件无法识别绑定规则的作用目标，直接忽略了绑定文件。
3. 配置缺失：原插件配置未明确指定WSDL和绑定文件路径，插件可能无法自动扫描到对应文件，导致绑定规则未生效。

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