Java8迁Java17后SOAP API报NAMESPACE_ERR问题求助

核心问题 #

后端服务从Java8/Spring Boot2.7/spring-ws-core3.1.1迁移至Java17/Spring Boot3.2/spring-ws-core4.0.8后，SOAP API抛出org.w3c.dom.DOMException: NAMESPACE_ERR，本质是XML命名空间处理不符合规范——Spring WS 4.x（适配Spring Boot3）对命名空间的校验比3.x更严格，同时Java17的XML相关实现（如JAXB、DOM）也有规范上的收紧。

排查与修复步骤 #

1. 校验命名空间一致性 #

• 确认Constants.Namespace.Internal的取值与SOAP请求中<loginRequest>元素的命名空间完全一致（包括大小写、末尾斜杠等细节）。例如请求中的命名空间为http://your-domain.com/internal/，常量值必须完全匹配，不能少斜杠或出现大小写错误。
• 检查LoginRequest、LoginResponse的JAXB注解，确保@XmlRootElement、@XmlType的namespace属性与@PayloadRoot指定的命名空间一致：

@XmlRootElement(namespace = Constants.Namespace.Internal, name = "loginRequest")
public class LoginRequest {
    // 字段与方法
}

2. 修复自定义异常的SOAP Fault命名空间 #

迁移后Spring WS 4.x对SOAP Fault的命名空间要求更严格，自定义异常需显式指定Fault的命名空间：

• 为自定义异常添加@SoapFault注解，指定命名空间：

@SoapFault(faultCode = FaultCode.CLIENT, namespace = Constants.Namespace.Internal)
public class PasswordExpiredFaultException extends Exception {
    public PasswordExpiredFaultException(String message) {
        super(message);
    }
}

• 若存在手动构建DOM元素的代码（如自定义Fault细节），必须使用createElementNS方法创建带命名空间的元素，而非createElement：

// 错误写法
Element detailElement = document.createElement("passwordExpiredDetail");
// 正确写法
Element detailElement = document.createElementNS(Constants.Namespace.Internal, "passwordExpiredDetail");

3. 适配Java17的XML依赖与配置 #

Java17移除了JAXB等XML相关的内置模块，需确保依赖完整：

• 添加JAXB运行时依赖：

<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
</dependency>

• 若为模块化项目，需在module-info.java中声明依赖：

requires jakarta.xml.bind;

4. 验证Spring WS配置兼容性 #

虽然未修改XML配置，但Spring WS 4.x的配置元素有版本适配要求：

• 检查Spring WS XML配置的命名空间声明，确保使用4.x对应的命名空间：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:ws="http://www.springframework.org/schema/web-services"
       xsi:schemaLocation="
           http://www.springframework.org/schema/beans
           https://www.springframework.org/schema/beans/spring-beans.xsd
           http://www.springframework.org/schema/web-services
           https://www.springframework.org/schema/web-services/web-services.xsd">
    <!-- 配置内容 -->
</beans>

• 确认Wsdl11Definition的targetNamespace与业务命名空间一致，WSDL关联的XML Schema命名空间也需匹配。

5. 调试与日志排查 #

开启Spring WS的TRACE级日志，完整记录SOAP请求/响应的XML内容，定位命名空间异常点：

• 在application.properties中添加日志配置：

logging.level.org.springframework.ws=DEBUG
logging.level.org.springframework.ws.server.MessageTracing=TRACE

• 使用SOAP UI/Postman模拟桌面应用的请求，对比迁移前后的XML结构，重点检查命名空间的声明与使用是否存在差异。

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