.NET 8调用SOAP服务报错：找不到无命名空间faultstring元素

问题原因 #

你的SOAP服务返回的Fault响应中，faultstring元素没有携带.NET客户端默认期望的SOAP命名空间（http://schemas.xmlsoap.org/soap/envelope/），或者Fault元素的顺序不符合.NET的解析要求，导致反序列化失败。

解决方案：自定义消息检查器修正Fault响应 #

通过添加客户端消息检查器，在.NET解析响应前修改SOAP Fault的格式，使其符合客户端的解析规则。

步骤1：实现自定义消息检查器 #

创建两个类，用来拦截并修改收到的SOAP响应：

using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Description;
using System.Xml;

public class SoapFaultFixInspector : IClientMessageInspector
{
    public void AfterReceiveReply(ref Message reply, object correlationState)
    {
        if (!reply.IsFault) return;

        // 加载原始响应内容
        var xmlDoc = new XmlDocument();
        using (var reader = reply.GetReaderAtBodyContents())
        {
            xmlDoc.Load(reader);
        }

        // 修复1：给faultstring添加SOAP命名空间
        var faultStringNodes = xmlDoc.GetElementsByTagName("faultstring");
        if (faultStringNodes.Count > 0)
        {
            var faultStringElement = faultStringNodes[0] as XmlElement;
            faultStringElement.SetAttribute("xmlns", "http://schemas.xmlsoap.org/soap/envelope/");
        }

        // 修复2：按.NET期望的顺序排列Fault子元素（可选，若存在顺序问题）
        var soapNsManager = new XmlNamespaceManager(xmlDoc.NameTable);
        soapNsManager.AddNamespace("soap", "http://schemas.xmlsoap.org/soap/envelope/");
        var faultNode = xmlDoc.SelectSingleNode("//soap:Fault", soapNsManager);
        if (faultNode != null)
        {
            var childNodes = faultNode.ChildNodes.Cast<XmlNode>().ToList();
            // 按faultcode > faultstring > faultactor > detail的顺序排序
            var orderedNodes = childNodes.OrderBy(node => node.LocalName switch
            {
                "faultcode" => 0,
                "faultstring" => 1,
                "faultactor" => 2,
                "detail" => 3,
                _ => 4
            }).ToList();

            faultNode.RemoveAll();
            foreach (var node in orderedNodes)
            {
                faultNode.AppendChild(node);
            }
        }

        // 用修正后的内容创建新的响应消息
        var fixedReply = Message.CreateMessage(reply.Version, "", xmlDoc.DocumentElement);
        fixedReply.Headers.CopyHeadersFrom(reply.Headers);
        fixedReply.Properties.CopyProperties(reply.Properties);
        reply = fixedReply;
    }

    public object BeforeSendRequest(ref Message request, IClientChannel channel) => null;
}

public class SoapFaultFixBehavior : IEndpointBehavior
{
    public void AddBindingParameters(ServiceEndpoint endpoint, BindingParameterCollection bindingParameters) { }

    public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
    {
        clientRuntime.ClientMessageInspectors.Add(new SoapFaultFixInspector());
    }

    public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher) { }

    public void Validate(ServiceEndpoint endpoint) { }
}

步骤2：在客户端中应用该行为 #

在初始化SOAP客户端后，将自定义行为添加到客户端的端点行为集合中：

// 替换成你的自动生成的SOAP客户端类名
var soapClient = new YourGeneratedSoapClient();
// 添加自定义行为修复Fault解析问题
soapClient.Endpoint.Behaviors.Add(new SoapFaultFixBehavior());

// 后续正常调用服务方法
try
{
    var result = soapClient.YourServiceMethod();
}
catch (FaultException ex)
{
    // 现在可以正常捕获并处理Fault了
    Console.WriteLine($"Fault代码：{ex.Code.Name}，消息：{ex.Message}");
}

其他注意事项 #

• 不要直接修改自动生成的Reference.cs文件（会被重新生成覆盖），优先使用上述行为扩展的方式。
• 若服务返回的Fault格式还有其他不符合标准的地方，可以在SoapFaultFixInspector的AfterReceiveReply方法中继续添加修正逻辑。

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