JAX-WS Maven插件跨平台构建：WSDL路径相对/绝对差异排查

问题根源分析 #

你遇到的跨平台差异，核心原因在于旧版本的jaxws-maven-plugin（2.5版）在Windows系统下对wsdlLocation参数的解析逻辑存在缺陷：

• 在Mac/Linux这类类Unix系统中，插件会将你配置的/service-api-definition/File01.wsdl识别为类路径根目录下的相对资源路径（符合预期，因为WSDL文件最终会被打包到Jar的service-api-definition目录下，属于类路径资源）。
• 但在Windows系统中，插件错误地将这个路径解析成了本地文件系统的绝对路径——它把配置的路径和wsdlDirectory的本地路径拼接起来，生成了C:/Users/USERNAME/git/src/main/resources/...这种本地绝对路径，而非保留类路径格式。

这种差异源于旧版本插件未统一处理跨平台的路径语义，混淆了类路径资源路径与本地文件路径的逻辑。

解决方案 #

要让Windows和Mac的构建结果一致，你可以尝试以下几种方案：

1. 升级jaxws-maven-plugin到最新稳定版

旧版本（2.5）的路径处理存在跨平台bug，升级到较新的稳定版（比如2.6.0或更高）可修复该问题。修改pom.xml中插件的版本：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>jaxws-maven-plugin</artifactId>
  <version>2.6.0</version> <!-- 替换为最新稳定版 -->
  <!-- 其余配置保持不变 -->
</plugin>

新版本插件会统一将wsdlLocation解析为类路径资源路径，不再受操作系统影响。

2. 显式指定wsdlLocation为类路径格式（兼容旧版本）

如果暂时无法升级插件，可在wsdlLocation前添加classpath:前缀，强制插件将其识别为类路径资源：

<execution>
  <id>wsdla-exec</id>
  <goals>
    <goal>wsimport</goal>
  </goals>
  <configuration>
    <wsdlLocation>classpath:/service-api-definition/File01.wsdl</wsdlLocation>
  </configuration>
</execution>
<execution>
  <id>wsdlb-exec</id>
  <goals>
    <goal>wsimport</goal>
  </goals>
  <configuration>
    <wsdlLocation>classpath:/service-api-definition/File02.wsdl</wsdlLocation>
  </configuration>
</execution>

这样插件在Windows下就不会错误解析成本地绝对路径，而是保留类路径格式。

3. 统一使用Maven属性管理路径

你可以定义一个Maven属性来统一WSDL的类路径路径，避免硬编码：

<properties>
  <wsdl.classpath.location>/service-api-definition/</wsdl.classpath.location>
</properties>

然后在插件配置中引用这个属性：

<wsdlLocation>${wsdl.classpath.location}File01.wsdl</wsdlLocation>

这种方式让配置更易维护，同时配合上述方案1或2，确保跨平台一致性。

验证方案 #

修改配置后，在Windows上重新执行mvn clean install，检查生成的File01Service.java和File02Service.java中的wsdlLocation字段，应该会和Mac上的结果一致，都是/service-api-definition/File01.wsdl（或带classpath:前缀的格式，这两种在Jar包中均可用）。

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