C# 使用 ClientBase 获取 SOAP 服务400错误响应详情的方案问询

1. 实现自定义客户端消息拦截器 #

通过实现WCF的IClientMessageInspector接口，即可在不修改原有调用逻辑的前提下，拦截服务端返回的所有响应，包括400状态码下的SOAP Fault详情：

// 自定义异常类，用于承载SOAP错误详情
public class CustomSoapFaultException : Exception
{
    public string FaultDetailXml { get; }
    public System.Net.HttpStatusCode StatusCode { get; set; }
    public CustomSoapFaultException(string faultDetailXml) : base("SOAP服务返回业务错误")
    {
        FaultDetailXml = faultDetailXml;
    }
}

// 消息拦截器实现
public class SoapFaultCaptureInspector : IClientMessageInspector
{
    public void AfterReceiveReply(ref Message reply, object correlationState)
    {
        if (reply.IsFault)
        {
            // 复制消息流，避免原消息被读取后无法继续处理
            var messageBuffer = reply.CreateBufferedCopy(int.MaxValue);
            var faultMessageCopy = messageBuffer.CreateMessage();
            reply = messageBuffer.CreateMessage();

            // 读取完整Fault节点内容
            using (var xmlReader = faultMessageCopy.GetReaderAtBodyContents())
            {
                var fullFaultXml = xmlReader.ReadOuterXml();
                if (!string.IsNullOrWhiteSpace(fullFaultXml))
                {
                    throw new CustomSoapFaultException(fullFaultXml)
                    {
                        StatusCode = System.Net.HttpStatusCode.BadRequest
                    };
                }
            }
        }
    }

    public object BeforeSendRequest(ref Message request, IClientChannel channel)
    {
        return null;
    }
}

// 终结点行为，用于注册拦截器
public class SoapFaultCaptureBehavior : IEndpointBehavior
{
    public void AddBindingParameters(ServiceEndpoint endpoint, BindingParameterCollection bindingParameters) { }
    public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
    {
        clientRuntime.MessageInspectors.Add(new SoapFaultCaptureInspector());
    }
    public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher) { }
    public void Validate(ServiceEndpoint endpoint) { }
}

2. 给AccountsClient注册拦截器 #

初始化AccountsClient时，添加自定义的终结点行为即可：

var accountsClient = new AccountsClient();
accountsClient.Endpoint.EndpointBehaviors.Add(new SoapFaultCaptureBehavior());

3. 调整异常捕获逻辑 #

后续调用服务接口时，捕获自定义的CustomSoapFaultException即可拿到完整的SOAP Fault详情，你可以根据需要把FaultDetailXml反序列化为强类型的错误对象，直接提取示例里的ruleDescField、ruleIdField等业务错误字段。

可选配置调整 #

如果拦截器读取到的内容被截断，可以修改绑定配置，开启Fault异常支持并调大消息接收上限：

• 配置文件方式：

<bindings>
  <basicHttpBinding>
    <binding name="YourBindingName" 
             faultExceptionEnabled="true" 
             maxReceivedMessageSize="2147483647">
    </binding>
  </basicHttpBinding>
</bindings>

• 代码配置方式：

var binding = new BasicHttpBinding();
binding.FaultExceptionEnabled = true;
binding.MaxReceivedMessageSize = int.MaxValue;

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