Spring Boot SOAP应用@Endpoint的自定义响应异常处理方案咨询

核心方案：扩展SoapFaultMappingExceptionResolver #

Spring WS的端点体系提供了SoapFaultMappingExceptionResolver类，通过继承它可以完全接管异常处理逻辑，绕过默认的SOAP Fault生成，返回自定义响应体。

步骤1：实现自定义异常解析器 #

创建类继承SoapFaultMappingExceptionResolver，重写customizeFault方法来控制响应内容：

import org.springframework.ws.soap.server.endpoint.SoapFaultMappingExceptionResolver;
import org.springframework.ws.soap.server.endpoint.SoapFaultDefinition;
import org.springframework.ws.soap.SoapMessage;
import org.springframework.ws.context.MessageContext;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

public class CustomSoapExceptionResolver extends SoapFaultMappingExceptionResolver {

    @Override
    protected void customizeFault(Object endpoint, Exception ex, SoapFaultDefinition faultDefinition, SoapMessage response) {
        // 清除默认SOAP Fault内容
        response.getSoapBody().removeContents();
        
        // 构造符合你业务规范的自定义SOAP响应
        Document doc = response.getDocument();
        Element customResponse = doc.createElementNS("http://your-business-namespace.com", "CustomResponse");
        
        Element status = doc.createElement("ResultStatus");
        status.setTextContent("FAILURE");
        Element errorDetail = doc.createElement("ErrorDetail");
        errorDetail.setTextContent(ex.getMessage());
        
        customResponse.appendChild(status);
        customResponse.appendChild(errorDetail);
        
        // 将自定义元素写入SOAP Body
        response.getSoapBody().addContent(customResponse);
    }
}

步骤2：注册解析器到Spring容器 #

在配置类中把自定义解析器注册为Bean，确保Spring WS能加载它：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.ws.soap.server.endpoint.SoapFaultMappingExceptionResolver;

@Configuration
public class SoapConfig {

    @Bean
    public SoapFaultMappingExceptionResolver customSoapExceptionResolver() {
        CustomSoapExceptionResolver resolver = new CustomSoapExceptionResolver();
        // 可选：绑定特定异常到对应处理逻辑
        // resolver.addFaultMapping(InvalidRequestException.class, new SoapFaultDefinition());
        return resolver;
    }
}

全局捕获全层级异常 #

这个解析器会捕获所有从@Endpoint方法抛出的异常——包括服务层、DAO层向上传播的异常，无需在各层级单独处理。如果需要针对不同异常返回差异化响应，可在customizeFault中通过instanceof判断异常类型，或用addFaultMapping绑定异常与处理逻辑。

轻量替代方案：实现EndpointExceptionResolver接口 #

如果觉得继承类太重，可直接实现EndpointExceptionResolver接口，完全自定义异常处理流程：

import org.springframework.ws.server.EndpointExceptionResolver;
import org.springframework.ws.context.MessageContext;
import org.springframework.ws.soap.SoapMessage;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

public class CustomEndpointExceptionResolver implements EndpointExceptionResolver {

    @Override
    public boolean resolveException(MessageContext messageContext, Object endpoint, Exception ex) {
        SoapMessage response = (SoapMessage) messageContext.getResponse();
        response.getSoapBody().removeContents();
        
        // 构造自定义响应，逻辑同前
        Document doc = response.getDocument();
        Element customResponse = doc.createElementNS("http://your-business-namespace.com", "CustomResponse");
        // 添加业务相关元素...
        
        response.getSoapBody().addContent(customResponse);
        return true; // 标记异常已处理，终止默认流程
    }
}

同样需要将该类注册为Spring Bean。

注意事项 #

• 自定义响应必须符合你的WSDL/XSD定义，避免客户端解析失败
• 无需修改HTTP状态码（默认200 OK即可），仅替换SOAP Body内容
• 针对业务异常可做分支处理，返回不同结构的自定义响应

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