单个Spring Boot应用能否同时支持REST与SOAP两种API？

1、是否支持同一端口同时暴露两类端点 #

完全可以实现。两类请求本质都是HTTP协议报文，只是报文格式、处理逻辑不同：

• 常规REST端点由Spring MVC的DispatcherServlet处理，默认映射根路径/*
• SOAP端点由Spring Web Services提供的MessageDispatcherServlet处理，只需为其配置独立的路径前缀（比如/ws/*），即可和REST端点在同一个Tomcat/Jetty等嵌入式容器的同一端口下共存，不会出现路径冲突。

2、实现示例参考 #

所需依赖 #

Maven依赖配置示例：

<!-- 原有REST相关依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 新增SOAP相关依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web-services</artifactId>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
</dependency>

SOAP核心配置 #

@Configuration
@EnableWs
public class SoapWebServiceConfig extends WsConfigurerAdapter {
    // 注册SOAP处理Servlet，映射到/ws/*路径，和REST路径隔离
    @Bean
    public ServletRegistrationBean<MessageDispatcherServlet> messageDispatcherServlet(ApplicationContext applicationContext) {
        MessageDispatcherServlet servlet = new MessageDispatcherServlet();
        servlet.setApplicationContext(applicationContext);
        servlet.setTransformWsdlLocations(true);
        return new ServletRegistrationBean<>(servlet, "/ws/*");
    }

    // 配置WSDL自动生成，访问/ws/xxx.wsdl即可获取
    @Bean(name = "user")
    public DefaultWsdl11Definition defaultWsdl11Definition(XsdSchema userSchema) {
        DefaultWsdl11Definition wsdl11Definition = new DefaultWsdl11Definition();
        wsdl11Definition.setPortTypeName("UserPort");
        wsdl11Definition.setLocationUri("/ws");
        wsdl11Definition.setTargetNamespace("http://yourdomain.com/ws/user");
        wsdl11Definition.setSchema(userSchema);
        return wsdl11Definition;
    }

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

SOAP端点示例 #

@Endpoint
public class UserSoapEndpoint {
    private static final String NAMESPACE_URI = "http://yourdomain.com/ws/user";

    @PayloadRoot(namespace = NAMESPACE_URI, localPart = "getUserRequest")
    @ResponsePayload
    public GetUserResponse getUser(@RequestPayload GetUserRequest request) {
        GetUserResponse response = new GetUserResponse();
        // 业务逻辑处理
        return response;
    }
}

原有REST端点的@RestController无需做任何修改，即可正常对外提供服务。

3、配置方案的适用性与弊端 #

适用场景 #

仅推荐临时过渡场景使用：比如已有REST服务需要兼容仅支持SOAP协议的老业务系统，且暂时没有资源拆分独立服务的场景。

不推荐长期使用的弊端 #

• 架构复杂度升高：两类协议的序列化/反序列化逻辑、异常处理规则、安全校验策略（REST常用JWT/ OAuth2，SOAP常用WS-Security）完全不同，需要同时维护两套逻辑，问题排查难度也会翻倍
• 资源开销更高：应用需要同时加载两套Servlet处理链、两套协议解析组件，内存占用、启动耗时都会明显升高
• 迭代维护成本高：后续领域模型迭代时，需要同时兼容两种协议的入参出参规则，只要其中一类接口不允许做兼容性改动，就会限制整体业务的迭代效率
• 安全风险更高：对外攻击面翻倍，需要同时防范REST类漏洞（SQL注入、CSRF等）和SOAP类漏洞（XML注入、XXE、WS-Security配置缺陷等），安全配置出错的概率也更高

内容的提问来源于stack exchange，提问作者Abhishek Sharma M