Spring Boot升级后SOAP服务通信异常：如何配置命名空间序列化？

问题根源 #

Spring Boot 3.1.x升级后，内嵌的JAXB序列化逻辑默认行为变更，导致SOAP请求中的嵌套Bean元素自动带上了服务命名空间前缀（如ns2:），而3.0.7版本生成的报文不带该前缀，引发反序列化异常。

具体配置方法 #

通过自定义CXF的JAXB Marshaller配置，指定服务命名空间使用空前缀，即可让3.1.2的服务生成与3.0.7一致的SOAP报文：

1. 创建命名空间前缀映射类 #

import com.sun.xml.bind.marshaller.NamespacePrefixMapper;

public class CustomNamespacePrefixMapper extends NamespacePrefixMapper {
    @Override
    public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
        // 替换为你的SOAP服务命名空间
        if ("http://some.package.structure/".equals(namespaceUri)) {
            return ""; // 空前缀，让子元素不带ns2标识
        }
        return suggestion;
    }
}

2. 配置CXF Endpoint #

创建Spring配置类，将自定义的前缀映射器绑定到SOAP服务的Marshaller：

import org.apache.cxf.jaxws.EndpointImpl;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import jakarta.xml.bind.Marshaller;
import javax.xml.ws.Endpoint;
import java.util.HashMap;
import java.util.Map;

@Configuration
public class SoapServiceConfig {

    private final YourSoapServiceImpl soapService; // 替换为你的SOAP服务实现类

    public SoapServiceConfig(YourSoapServiceImpl soapService) {
        this.soapService = soapService;
    }

    @Bean
    public Endpoint soapEndpoint() {
        EndpointImpl endpoint = new EndpointImpl(soapService);
        endpoint.setProperties(getMarshallerProps());
        endpoint.publish("/your-service-endpoint"); // 替换为你的服务发布路径
        return endpoint;
    }

    private Map<String, Object> getMarshallerProps() {
        Map<String, Object> props = new HashMap<>();
        props.put(Marshaller.JAXB_NS_PREFIX_MAPPER, new CustomNamespacePrefixMapper());
        // 可选：开启格式化输出，和旧版本保持一致的报文格式
        props.put(Marshaller.JAXB_FORMATTED_OUTPUT, true);
        return props;
    }
}

3. 依赖说明 #

如果项目中缺少com.sun.xml.bind.marshaller.NamespacePrefixMapper类，需添加JAXB实现依赖（Spring Boot 3.x默认依赖Jakarta版本）：

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

验证 #

配置完成后，重启3.1.2版本的SOAP服务，发起updateWorkflowConfiguration请求，生成的报文子元素将不再带有ns2:前缀，与3.0.7版本完全一致，即可解决跨版本通信的反序列化异常。

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