Spring-WS异常处理：自定义返回CFault而非响应类型A

绝对可以实现！这种场景在SOAP服务开发里太常见了——我之前帮同事处理过几乎一模一样的需求。核心思路就是通过自定义错误处理器捕获你的ExpEx异常，然后把它转换成WSDL里定义好的CFault响应返回，完全不用纠结正常流程的响应类型A。

下面给你分步骤拆解实现方案，我会覆盖常用的JAX-WS和Spring WS两种框架，你可以根据自己的技术栈选：

首先得确保你的WSDL里已经正确定义了CFault的结构，比如类似这样的片段：

<wsdl:fault name="CFault">
  <wsdl:faultMessage name="CFaultMsg">
    <wsdl:part name="faultDetail" element="tns:CFault"/>
  </wsdl:faultMessage>
</wsdl:fault>

而且对应的Java实体类（一般是用JAXB从WSDL生成的）要和这个定义完全匹配，包含错误码、错误消息这些你需要的字段，不然后面序列化出来的XML不符合规范，客户端会解析失败。

方式一：JAX-WS 用ExceptionMapper #

如果你的服务是基于JAX-WS开发的，直接实现ExceptionMapper接口就能搞定：

import javax.ws.rs.core.Response;
import javax.ws.rs.ext.ExceptionMapper;
import javax.ws.rs.ext.Provider;

@Provider
public class ExpExExceptionMapper implements ExceptionMapper<ExpEx> {

    @Override
    public Response toResponse(ExpEx exception) {
        // 实例化WSDL定义的CFault，把异常信息填进去
        CFault cFault = new CFault();
        cFault.setErrorCode("DOWNSTREAM_SERVICE_FAILURE");
        cFault.setErrorMessage(exception.getMessage());
        
        // 构建SOAP Fault响应，状态码用500（内部服务错误）就很合适
        return Response.status(Response.Status.INTERNAL_SERVER_ERROR)
                .entity(cFault)
                .build();
    }
}

写完之后别忘了把这个处理器注册到你的JAX-WS服务里——要么在web.xml里配置，要么确保你的框架能扫描到@Provider注解。

方式二：Spring WS 扩展SoapFaultMappingExceptionResolver #

如果用的是Spring WS，那就扩展SoapFaultMappingExceptionResolver来做自定义映射：

import org.springframework.ws.soap.server.endpoint.SoapFaultMappingExceptionResolver;
import org.springframework.ws.soap.server.endpoint.SoapFaultDefinition;
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;

public class CustomSoapFaultResolver extends SoapFaultMappingExceptionResolver {

    public CustomSoapFaultResolver() {
        // 把ExpEx和我们要返回的CFault绑定起来
        registerException(ExpEx.class, createCFaultDefinition());
    }

    private SoapFaultDefinition createCFaultDefinition() {
        SoapFaultDefinition faultDefinition = new SoapFaultDefinition();
        faultDefinition.setFaultCode(SoapFaultDefinition.SERVER);
        faultDefinition.setFaultStringOrReason("下游服务调用失败");
        return faultDefinition;
    }

    @Override
    protected void customizeFault(Object endpoint, Exception ex, SoapFault fault) {
        if (ex instanceof ExpEx) {
            ExpEx expEx = (ExpEx) ex;
            // 创建CFault实例并填充异常细节
            CFault cFault = new CFault();
            cFault.setErrorCode("DS_CALL_FAILED");
            cFault.setErrorMessage(expEx.getCause() != null ? expEx.getCause().getMessage() : expEx.getMessage());
            
            // 把CFault序列化成XML，添加到SOAP Fault的detail部分
            try {
                JAXBContext context = JAXBContext.newInstance(CFault.class);
                Marshaller marshaller = context.createMarshaller();
                marshaller.marshal(cFault, fault.getFaultDetail().getResult());
            } catch (JAXBException e) {
                // 这里可以加个日志记录序列化失败的情况
                logger.error("Failed to serialize CFault to XML", e);
            }
        }
        super.customizeFault(endpoint, ex, fault);
    }
}

然后在Spring的配置文件里注册这个Resolver：

<bean id="soapFaultResolver" class="com.yourcompany.yourpackage.CustomSoapFaultResolver"/>

• 一定要保证CFault的JAXB绑定是正确的，和WSDL定义完全对应，不然返回的XML结构不对，客户端会报错。
• 异常处理器必须被框架正确扫描或注册，不然它根本捕获不到ExpEx异常。
• 如果你的服务有多个端点，要确认处理器的作用范围覆盖到了你需要的那个端点。

这样配置好之后，当你的服务处理请求时抛出ExpEx异常，框架就会自动调用你写的自定义处理器，返回符合WSDL规范的CFault响应，而不是正常的响应类型A或者默认的异常信息。

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