如何阻止Java 21强制为SOAP请求添加ns2前缀，兼容Java8/21？

问题背景 #

• 原Java8环境的SOAP应用，需同时兼容Java8和Java21
• Java8下请求格式正常：soap:Body<DDataSendReq>，可正常调用第三方WebService
• Java21环境中，Eclipse直接运行应用正常，但打包成JAR后请求被强制添加ns2前缀，变为soap:Body<ns2:DDataSendReq>，触发第三方服务报错

无效排查尝试 #

• 修改package-info.java设置命名空间前缀为空
• 自定义NamespacePrefixMapper实现类强制前缀为空
• 删除package-info.java文件
• 升级Hibernate从4.x到6.x以移除javax依赖

根因分析 #

maven-shade-plugin打包fat-JAR时，未正确合并CXF相关的META-INF目录配置文件（如jaxb.index、namespace-prefix-mapper.properties等），导致CXF在Java21环境下无法加载正确的命名空间映射规则，自动生成了ns2前缀。而Eclipse运行时直接加载零散类文件与资源，不存在资源合并冲突，因此无异常。

解决方案 #

替换maven-shade-plugin为其他打包方式，示例选项：

• 使用maven-assembly-plugin配合jar-with-dependencies描述符打包
• 若为Spring应用，使用Spring Boot Maven Plugin打包
• 切换到Gradle构建，使用shadow插件打包

日志对比 #

Java8下正常请求日志 #

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DDataSendReq xmlns="http://your.target.namespace/">
      <!-- 业务请求内容 -->
    </DDataSendReq>
  </soap:Body>
</soap:Envelope>

Java21下错误请求日志 #

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns2="http://your.target.namespace/">
  <soap:Body>
    <ns2:DDataSendReq>
      <!-- 业务请求内容 -->
    </ns2:DDataSendReq>
  </soap:Body>
</soap:Envelope>

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