如何为Spring WebService配置全局SOAP错误处理器处理无效请求？

问题核心 #

SoapMessageCreationException这类SOAP解析异常属于端点处理前的早期异常，默认Spring WS会返回包含具体解析细节的Fault，而自定义带@SoapFault的异常类无法自动捕获这类内部异常，需要通过注册全局异常解析器来拦截处理。

步骤1：创建自定义异常（可选，用于统一Fault格式） #

如果希望通过注解定义Fault格式，先创建带@SoapFault的异常类：

import org.springframework.ws.soap.server.endpoint.annotation.FaultCode;
import org.springframework.ws.soap.server.endpoint.annotation.SoapFault;

@SoapFault(
    faultCode = FaultCode.CLIENT,
    faultStringOrReason = "无效的SOAP请求，请检查请求格式后重试"
)
public class InvalidSoapRequestException extends RuntimeException {
    public InvalidSoapRequestException(String message) {
        super(message);
    }
}

步骤2：实现全局异常解析器 #

继承SimpleSoapExceptionResolver，重写方法捕获解析类异常，返回自定义通用Fault：

import org.springframework.ws.context.MessageContext;
import org.springframework.ws.soap.SoapBody;
import org.springframework.ws.soap.SoapFault;
import org.springframework.ws.soap.server.endpoint.SimpleSoapExceptionResolver;
import org.springframework.ws.soap.saaj.SaajSoapMessage;
import org.springframework.ws.soap.SoapMessageCreationException;

public class CustomSoapExceptionResolver extends SimpleSoapExceptionResolver {

    @Override
    protected void customizeFault(MessageContext messageContext, Object endpoint, Exception ex) {
        // 捕获SOAP请求解析失败的异常
        if (ex instanceof SoapMessageCreationException) {
            SaajSoapMessage response = (SaajSoapMessage) messageContext.getResponse();
            SoapBody soapBody = response.getSoapBody();
            
            // 添加客户端Fault，返回通用提示
            SoapFault fault = soapBody.addClientOrSenderFault(
                "无效的SOAP请求，请检查请求格式后重试",
                null
            );
            
            // 移除默认的详细错误节点（避免泄露具体解析信息）
            if (fault.getFaultDetail() != null) {
                fault.getFaultDetail().getResult().getNode().getParentNode().removeChild(
                    fault.getFaultDetail().getResult().getNode()
                );
            }
        } else {
            // 其他异常按默认逻辑处理
            super.customizeFault(messageContext, endpoint, ex);
        }
    }
}

步骤3：在spring-integration.xml中注册解析器 #

将自定义解析器注册为Bean，并关联到SOAP端点组件：

方式1：配合sws:annotation-driven

如果使用注解驱动的SOAP端点：

<!-- 注册自定义异常解析器 -->
<bean id="customSoapExceptionResolver" class="com.yourpackage.CustomSoapExceptionResolver" />

<!-- 配置注解驱动的SOAP端点，绑定异常解析器 -->
<sws:annotation-driven exception-resolvers="customSoapExceptionResolver" />

方式2：配合Spring Integration WS入站网关

如果使用Spring Integration的WS网关：

<!-- 注册自定义异常解析器 -->
<bean id="customSoapExceptionResolver" class="com.yourpackage.CustomSoapExceptionResolver" />

<!-- 配置WS入站网关，指定异常解析器 -->
<int-ws:inbound-gateway id="wsInboundGateway"
    request-channel="requestChannel"
    reply-channel="replyChannel"
    marshaller="yourMarshaller"
    unmarshaller="yourMarshaller"
    exception-resolver="customSoapExceptionResolver" />

关键说明 #

• SoapMessageCreationException发生在消息解析阶段，早于端点方法执行，因此无法通过业务代码抛出的自定义异常捕获，必须通过全局解析器拦截。
• 自定义解析器中直接构造SOAP Fault，可以完全控制返回的错误内容，避免泄露如XML语法错误等敏感细节。

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