Spring WS：无命名空间且本地部分相同的多服务部署问题

方案1：为每个服务配置独立的MessageDispatcherServlet及Endpoint容器 #

通过给每个服务分配独立的Servlet和Spring配置上下文，让不同URL对应各自的Endpoint集合，避免跨服务的@PayloadRoot冲突。

实现步骤 #

1. 为每个服务创建独立的WS配置类，注册专属的MessageDispatcherServlet和WSDL定义：

@Configuration
@EnableWs
public class Service1Config extends WsConfigurerAdapter {
    @Bean
    public ServletRegistrationBean service1DispatcherServlet(ApplicationContext ctx) {
        MessageDispatcherServlet servlet = new MessageDispatcherServlet();
        servlet.setApplicationContext(ctx);
        servlet.setTransformWsdlLocations(true);
        // 绑定服务1的URL路径
        return new ServletRegistrationBean(servlet, "/soap/service1/*");
    }

    @Bean(name = "service1Wsdl")
    public DefaultWsdl11Definition service1Wsdl(XsdSchema ordersSchema) {
        DefaultWsdl11Definition wsdl = new DefaultWsdl11Definition();
        wsdl.setPortTypeName("Service1Port");
        wsdl.setLocationUri("/soap/service1");
        wsdl.setTargetNamespace("http://your-domain.com/service1");
        wsdl.setSchema(ordersSchema);
        return wsdl;
    }

    @Bean
    public XsdSchema ordersSchema() {
        return new SimpleXsdSchema(new ClassPathResource("orders.xsd"));
    }
}

2. 每个服务的Endpoint类独立编写，使用对应配置类的命名空间：

@Endpoint
public class Service1Endpoint {
    private static final String NAMESPACE_URI = "http://your-domain.com/service1";

    @PayloadRoot(namespace = NAMESPACE_URI, localPart = "OrdersRequest")
    @ResponsePayload
    public OrdersResponse handleOrdersRequest(@RequestPayload OrdersRequest request) {
        // 服务1专属业务逻辑
        OrdersResponse response = new OrdersResponse();
        // 处理请求并返回结果
        return response;
    }
}

同理复制配置和Endpoint类，修改Servlet路径（如/soap/service2）和命名空间，即可实现三个服务独立部署且无冲突。

方案2：自定义URL感知的PayloadRootAnnotationMethodEndpointMapping #

通过重写映射逻辑，结合请求URL生成唯一的Endpoint匹配键，解决同localPart的冲突问题。

实现步骤 #

1. 自定义映射类，结合请求URL和Payload信息生成唯一键：

@Component
public class UrlAwarePayloadRootMapping extends PayloadRootAnnotationMethodEndpointMapping {
    // 自定义注解标记服务对应的URL前缀
    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface ServiceUrl {
        String value();
    }

    @Override
    protected Object getLookupKeyForMessage(MessageContext messageContext) throws Exception {
        // 从请求中获取URL路径
        HttpServletRequest request = ((ServletWebRequest) messageContext.getRequest()).getRequest();
        String requestUrl = request.getRequestURI();
        // 结合原PayloadRoot键生成唯一标识
        Object originalKey = super.getLookupKeyForMessage(messageContext);
        return requestUrl + ":" + originalKey;
    }

    @Override
    protected Object getLookupKeyForMethod(Method method) {
        // 读取Endpoint类上的@ServiceUrl注解，生成匹配键
        ServiceUrl serviceUrl = method.getDeclaringClass().getAnnotation(ServiceUrl.class);
        if (serviceUrl == null) {
            throw new IllegalArgumentException("Endpoint类必须添加@ServiceUrl注解");
        }
        Object originalKey = super.getLookupKeyForMethod(method);
        return serviceUrl.value() + ":" + originalKey;
    }
}

2. 在Endpoint类上标记对应URL前缀：

@Endpoint
@ServiceUrl("/soap/service1")
public class Service1Endpoint {
    @PayloadRoot(localPart = "OrdersRequest", namespace = "")
    @ResponsePayload
    public OrdersResponse handleRequest(@RequestPayload OrdersRequest request) {
        // 业务逻辑实现
        return new OrdersResponse();
    }
}

此时Spring会根据URL+PayloadRoot的组合匹配对应的Endpoint，不会出现键重复问题。

方案3：结合@SoapAction注解区分请求 #

如果三个服务的客户端请求携带不同的SOAPAction头，可以通过@PayloadRoot+@SoapAction的组合来匹配Endpoint。

实现示例 #

@Endpoint
public class Service1Endpoint {
    @PayloadRoot(localPart = "OrdersRequest", namespace = "")
    @SoapAction("http://your-domain.com/service1/OrdersAction")
    @ResponsePayload
    public OrdersResponse handleService1Request(@RequestPayload OrdersRequest request) {
        // 服务1逻辑
        return new OrdersResponse();
    }
}

@Endpoint
public class Service2Endpoint {
    @PayloadRoot(localPart = "OrdersRequest", namespace = "")
    @SoapAction("http://your-domain.com/service2/OrdersAction")
    @ResponsePayload
    public OrdersResponse handleService2Request(@RequestPayload OrdersRequest request) {
        // 服务2逻辑
        return new OrdersResponse();
    }
}

Spring WS会同时校验PayloadRoot和SoapAction的匹配关系，实现同请求体的不同服务路由。

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