Spring Boot+Apache CXF SOAP服务命名空间前缀截断问题

我用Spring Boot搭配Apache CXF搭建SOAP服务，要求命名空间前缀使用7字符的testNs，但实际生成的请求里前缀被截断成了4字符的test。

示例代码 #

@WebService(targetNamespace = "http://example.com/testNs", name = "SoapService")
@Features(features = "org.apache.cxf.ext.logging.LoggingFeature")
@BindingType(SOAPBinding.SOAP12HTTP_MTOM_BINDING)
public interface SoapService {
    @WebResult(name = "ResultMsg")
    @RequestWrapper(localName = "Wrapper")
    ResultMsg soapReq(@WebParam(name = "requestId", targetNamespace = "http://example.com/testNs") String requestId,
                      @WebParam(name = "smsFlag", targetNamespace = "http://example.com/testNs") String status);
}

当前生成的请求XML #

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:test="http://example.com/testNs">
    <soapenv:Header/>
    <soapenv:Body>
        <test:Wrapper>
            <test:requestId>0000228610</test:requestId>
            <test:status>1</test:status>
        </test:Wrapper>
    </soapenv:Body>
</soapenv:Envelope>

期望的请求XML #

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:testNs="http://example.com/testNs">
    <soapenv:Header/>
    <soapenv:Body>
        <testNs:Wrapper>
            <testNs:requestId>0000228610</test:requestId>
            <testNs:status>1</test:status>
        </testNs:Wrapper>
    </soapenv:Body>
</soapenv:Envelope>

解决方案 #

方法一：自定义NamespacePrefixMapper强制指定前缀 #

CXF默认会自动截取命名空间的最后一段生成短前缀，我们可以通过自定义NamespacePrefixMapper来覆盖这个逻辑：

1. 实现自定义前缀映射类

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

public class CustomNamespacePrefixMapper extends NamespacePrefixMapper {
    @Override
    public String getPreferredPrefix(String namespaceUri, String suggestion, boolean requirePrefix) {
        // 匹配目标命名空间，返回指定前缀
        if ("http://example.com/testNs".equals(namespaceUri)) {
            return "testNs";
        }
        // 其他命名空间使用默认逻辑
        return super.getPreferredPrefix(namespaceUri, suggestion, requirePrefix);
    }
}

2. 在CXF服务配置中注册这个映射类
   如果是Spring Boot Java配置方式：

import org.apache.cxf.jaxws.EndpointImpl;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.xml.ws.Endpoint;

@Configuration
public class CxfConfig {
    @Bean
    public Endpoint endpoint(SoapService soapService) {
        EndpointImpl endpoint = new EndpointImpl(soapService);
        // 将自定义前缀映射类加入Endpoint属性
        endpoint.getProperties().put("jaxb.namespacePrefixMapper", new CustomNamespacePrefixMapper());
        endpoint.publish("/soapService");
        return endpoint;
    }
}

如果是XML配置方式：

<jaxws:endpoint id="soapService" implementor="com.example.SoapServiceImpl" address="/soapService">
    <jaxws:properties>
        <entry key="jaxb.namespacePrefixMapper" value="com.example.CustomNamespacePrefixMapper"/>
    </jaxws:properties>
</jaxws:endpoint>

方法二：补全RequestWrapper的命名空间配置 #

确保@RequestWrapper注解也指定正确的目标命名空间，避免前缀生成逻辑混乱：

@RequestWrapper(localName = "Wrapper", targetNamespace = "http://example.com/testNs")

这样配置后，生成的SOAP请求就会使用指定的testNs前缀，不会被截断。

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