大网数据广告活动
.NET 与 C# 开发

WCF 疑难解答快速入门

· 52CE 我爱测

本主题列出了一些客户开发 WCF 客户端和服务时所遇到的已知问题。 如果您遇到的问题不在此列表中,我们建议您为您的服务配置跟踪。 这将生成一个跟踪文件,您可以使用跟踪文件查看器查看它并获取有关服务中可能发生的异常的详细信息。 有关配置跟踪的详细信息,请参阅:配置跟踪。 跟踪文件查看器的详细信息,请参阅:服务跟踪查看器工具 (SvcTraceViewer.exe)。

本主题列出了一些客户开发 WCF 客户端和服务时所遇到的已知问题。 如果您遇到的问题不在此列表中,我们建议您为您的服务配置跟踪。 这将生成一个跟踪文件,您可以使用跟踪文件查看器查看它并获取有关服务中可能发生的异常的详细信息。 有关配置跟踪的详细信息,请参阅:配置跟踪。 跟踪文件查看器的详细信息,请参阅:服务跟踪查看器工具 (SvcTraceViewer.exe)。

  1. 安装 Windows 7 和 IIS 后,当我尝试浏览到 WCF 服务时收到以下错误消息:HTTP 错误 404.3 – 找不到

    HTTP 错误 404.3 – 找不到:由于扩展配置,无法提供您请求的页面。 如果此页是脚本,请添加处理程序。 如果应下载文件,请添加 MIME 映射。 详细错误 InformationModule StaticFileModule。

  2. 如果我的客户端在第一次请求后暂时处于空闲,有时我会在第二次请求时收到 MessageSecurityException。发生了什么情况?

  3. 大约有 10 个客户端与我的服务交互后,我的服务开始拒绝新的客户端。发生了什么情况?

  4. 我是否可以从 WCF 应用程序的配置文件以外的某处加载我的服务配置?

  5. 我的服务和客户端工作得很好,但是当客户端位于另一台计算机上时,为何就无法正常工作?发生了什么情况?

  6. 当我引发 FaultException<异常 > 的类型为异常,我总是接收客户端上的一个常规 FaultException 类型而不是泛型类型。发生了什么情况?

  7. 当答复未包含任何数据时,单向操作与请求-答复操作的返回速度似乎基本相同。发生了什么情况?

  8. 我对我的服务使用的是 X.509 证书,并且获得一个 System.Security.Cryptography.CryptographicException。发生了什么情况?

  9. 我将操作的第一个参数从大写更改为了小写,现在我的客户端引发一个异常。发生了什么情况?

  10. 我正在使用我的跟踪工具之一,并且获得一个 EndpointNotFoundException。发生了什么情况?

  11. 从 WCF SOAP 应用程序调用 WCF Web HTTP 应用程序时该服务将返回以下错误:不允许使用 405 方法

何为基址?它如何关联到一个终结点地址?

安装 Windows 7 和 IIS 后,当我尝试浏览到 WCF 服务时收到以下错误消息:HTTP 错误 404.3 – 找不到

完整错误消息为:

HTTP 错误 404.3 – 找不到:由于扩展配置,无法提供您请求的页面。 如果此页是脚本,请添加处理程序。 如果应下载文件,请添加 MIME 映射。 详细错误 InformationModule StaticFileModule。

在控制面板中未显式设置"Windows Communication Foundation HTTP 激活"时,将出现此错误消息。 若要设置此项,请转到控制面板,并在窗口的左下角单击“程序”。 单击“打开或关闭 Windows 功能”。 展开 Microsoft .NET Framework 3.5.1,选中“Windows Communication Foundation HTTP 激活”。

如果我的客户端在第一次请求后暂时处于空闲,有时我会在第二次请求时收到 MessageSecurityException。 发生了什么情况?

第二个请求可能会失败,原因有两个主要:(1) 会话已超时或者 (2) 将托管服务的 Web 服务器被回收。 在第一种情况下,会话在服务超时前有效。当服务在其绑定指定的时间段 (xref:System.ServiceModel.Channels.Binding.ReceiveTimeout*) 内未接收到来自客户端的请求时,服务将终止安全会话。 后续客户端消息会导致 xref:System.ServiceModel.Security.MessageSecurityException。 客户端必须重新建立与服务的安全会话,才能发送以后的消息或使用有状态安全上下文令牌。 有状态的安全上下文令牌还允许安全会话在回收 Web 服务器后存在。 有关在安全会话中使用有状态安全上下文令牌的详细信息,请参阅如何:创建安全上下文令牌的安全会话。 或者,也可禁用安全会话。 当你使用 <wsHttpBinding >绑定,您可以设置establishSecurityContext属性设置为false以禁用安全会话。 若要为其他绑定禁用安全会话,必须创建自定义绑定。 有关创建自定义绑定的详细信息,请参阅如何:创建自定义绑定使用 SecurityBindingElement。 在应用任何这些选择前,您必须先了解应用程序的安全要求。

大约有 10 个客户端与我的服务交互后,我的服务开始拒绝新的客户端。 发生了什么情况?

默认情况下,服务最多只能有 10 个并发会话。 因此,如果服务绑定使用会话,则服务将接受新的客户端连接,直到到达该数目;之后,它将拒绝新的客户端连接,直到当前会话之一结束。 可以通过多种方式支持更多的客户端。 如果你的服务不要求会话,则不要使用会话绑定。 (有关详细信息,请参阅使用会话的。)另一种选择是增大会话限制,方法是将 xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentSessions* 属性的值更改为适合您环境的数字。

我是否可以从 WCF 应用程序的配置文件以外的某处加载我的服务配置?

是。不过,您必须创建自定义 xref:System.ServiceModel.ServiceHost 类,并重写 xref:System.ServiceModel.ServiceHostBase.ApplyConfiguration* 方法。 在此方法内,您可以调用 base 先加载配置(如果您还要加载标准配置信息),但是也可以整个替换配置加载系统。 请注意,如果要从一个不同于应用程序配置文件的配置文件中加载配置,则必须自行分析配置文件,然后加载配置。

下面的代码示例演示如何重写 xref:System.ServiceModel.ServiceHostBase.ApplyConfiguration* 方法以及直接配置终结点。

public class MyServiceHost : ServiceHost  
{  
    public MyServiceHost(Type serviceType, params Uri[] baseAddresses)    
      : base(serviceType, baseAddresses)  
    {
        Console.WriteLine("MyServiceHost Constructor");
    }  
  
    protected override void ApplyConfiguration()  
    {  
        string straddress = GetAddress();  
        Uri address = new Uri(straddress);  
        Binding binding = GetBinding();  
        base.AddServiceEndpoint(typeof(IData), binding, address);  
    }  
  
    string GetAddress()  
    {
        return "http://MyMachine:7777/MyEndpointAddress/";
    }  
  
    Binding GetBinding()  
    {  
        WSHttpBinding binding = new WSHttpBinding();  
        binding.Security.Mode = SecurityMode.None;  
        return binding;  
    }  
}  

我的服务和客户端工作得很好,但是当客户端位于另一台计算机上时,为何就无法正常工作? 发生了什么情况?

根据异常的不同,可能会有多个问题:

  • 可能需要将客户端终结点的地址更改为主机名,而不是“localhost”。

  • 可能需要打开应用程序的端口。 有关详细信息,请参阅 SDK 示例中的 Firewall Instructions 。

  • 有关其他可能的问题,请参阅示例主题运行 Windows Communication Foundation 示例。

  • 如果客户端使用的是 Windows 凭据并且异常为 xref:System.ServiceModel.Security.SecurityNegotiationException,则按如下方式配置 Kerberos。

    1. 将标识凭据添加到客户端的 App.config 文件中的终结点元素:

      <endpoint   
        address="http://MyServer:8000/MyService/"   
        binding="wsHttpBinding"   
        bindingConfiguration="WSHttpBinding_IServiceExample"   
        contract="IServiceExample"   
        behaviorConfiguration="ClientCredBehavior"   
        name="WSHttpBinding_IServiceExample">  
        <identity>  
          <userPrincipalName value="name@corp.contoso.com"/>  
        </identity>  
      </endpoint>  
      
    2. 在 System 或 NetworkService 帐户下运行自承载服务。 可以运行此命令在 System 帐户下创建命令窗口:

      at 12:36 /interactive "cmd.exe"  
      
    3. 在 Internet 信息服务 (IIS) 下承载服务,默认情况下,IIS 使用服务主体名称 (SPN) 帐户。

    4. 使用 SetSPN 在域中注册一个新的 SPN。 请注意,您需要具有域管理员的身份才能执行此操作。

有关 Kerberos 协议的详细信息,请参阅WCF 中使用的安全概念和:

当我引发 FaultException<异常 > 的类型为异常,我总是接收客户端上的一个常规 FaultException 类型而不是泛型类型。 发生了什么情况?

强烈建议您创建自己的自定义错误数据类型,并在您的错误协定中将其声明为详细信息类型。 原因是使用系统提供的异常类型:

但是,如果您正在调试应用程序,则可以序列化异常信息,并使用 xref:System.ServiceModel.Description.ServiceDebugBehavior 类将其返回到客户端。

当答复未包含任何数据时,单向操作与请求-答复操作的返回速度似乎基本相同。 发生了什么情况?

指定一个操作为单向只表示操作协定接受输入消息,而不返回输出消息。 在 WCF 中,所有客户端调用返回时的出站数据写入网络或引发异常。 单向操作以相同方式工作,如果找不到服务则它们可以引发;或者如果服务没有准备好从网络接受数据则它们可以阻止。 通常在 WCF 中,这会导致单向调用返回到客户端速度比请求-答复快;但会降低速度通过网络发送的出站数据的任何条件会降低单向操作,以及请求-答复操作。 有关详细信息,请参阅单向服务并使用 WCF 客户端访问服务。

我对我的服务使用的是 X.509 证书,并且获得一个 System.Security.Cryptography.CryptographicException。 发生了什么情况?

这通常发生在更改了 IIS 辅助进程运行时所使用的用户帐户之后。 例如,在 Windows XP中,如果将 Aspnet_wp.exe 运行时所使用的默认用户帐户 ASPNET 更改为自定义用户帐户,则您可能会看到此错误。 如果使用的是私钥,则使用该私钥的进程需要具有访问存储该私钥的文件的权限。

如果的确如此,则必须向该进程的帐户授予对包含该私钥的文件的读访问特权。 例如,如果 IIS 辅助进程运行在 Bob 帐户下,则您需要向 Bob 授予对包含该私钥的文件的读访问权。

有关如何授予对包含特定 X.509 证书的私钥的文件的正确的用户帐户访问权限的详细信息,请参阅如何:使 X.509 证书可由 WCF 访问。

我将操作的第一个参数从大写更改为了小写,现在我的客户端引发一个异常。 发生了什么情况?

操作签名中的参数名称值是协定的一部分且区分大小写。 当需要区分本地参数名称与描述客户端应用程序操作的元数据时,请使用 xref:System.ServiceModel.MessageParameterAttribute?displayProperty=nameWithType 属性。

我正在使用我的跟踪工具之一,并且获得一个 EndpointNotFoundException。 发生了什么情况?

如果使用不是系统提供的 WCF 跟踪机制的跟踪工具时你收到xref:System.ServiceModel.EndpointNotFoundException,该值指示出现地址筛选器不匹配,您需要使用xref:System.ServiceModel.Description.ClientViaBehavior类,以将消息定向到跟踪实用工具和必须将这些消息重定向到服务地址的实用程序。 xref:System.ServiceModel.Description.ClientViaBehavior 类更改 Via 寻址标头,以独立于最终接收方(由 To 寻址标头指示)指定下一个网络地址。 但是,执行此操作时请不要更改终结点地址,它用于设立 To 值。

下面的代码示例演示一个示例客户端配置文件。

<endpoint   
  address="http://localhost:8000/MyServer/"  
  binding="wsHttpBinding"  
  bindingConfiguration="WSHttpBinding_IMyContract"  
  behaviorConfiguration="MyClient"   
  contract="IMyContract"   
  name="WSHttpBinding_IMyContract">  
</endpoint>  
<behaviors>  
  <endpointBehaviors>  
    <behavior name="MyClient">  
      <clientVia viaUri="http://localhost:8001/MyServer/"/>  
    </behavior>  
  </endpointBehaviors>  
</behaviors>  

何为基址? 它如何关联到一个终结点地址?

基址是 xref:System.ServiceModel.ServiceHost 类的根地址。 默认情况下,如果将一个 xref:System.ServiceModel.Description.ServiceMetadataBehavior 类添加到您的服务配置中,主机发布的所有终结点的 Web 服务描述语言 (WSDL) 都将从 HTTP 基址、提供给元数据行为的任何相对地址以及“?wsdl”中检索。 如果您熟悉 ASP.NET 和 IIS,基址相当于虚拟目录。

使用 NetTcpBinding 共享服务终结点和 MEX 终结点之间的端口

如果将服务的基址指定为 net.tcp://MyServer:8080/MyService 并添加以下终结点:

<services>  
  <service name="Microsoft.Samples.NetTcp.CalculatorService">  
    <endpoint address="calcsvc" binding ="netTcpBinding" contract="Microsoft.Samples.NetTcp.ICalculator"/>  
    <endpoint address="mex" binding="mexTcpBinding" contract="IMetadataExchange" />  
  </service>  
</services>  

如果按下面的配置代码段所示修改某个 NetTcpBinding 设置:

<bindings>  
  <netTcpBinding>  
    <binding closeTimeout="00:01:00" openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00" transactionFlow="false" transferMode="Buffered" transactionProtocol="OleTransactions" hostNameComparisonMode="StrongWildcard" listenBacklog="10" maxBufferPoolSize="524288" maxBufferSize="65536" maxConnections="11" maxReceivedMessageSize="65536">  
      <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384"/>  
      <reliableSession ordered="true" inactivityTimeout="00:10:00" enabled="false"/>  
      <security mode="Transport">  
        <transport clientCredentialType="Windows" protectionLevel="EncryptAndSign"/>  
      </security>  
    </binding>  
  </netTcpBinding>  
</bindings>  

你将看到如下所示的错误:未经处理的异常:System.ServiceModel.AddressAlreadyInUseException:可以通过使用以下配置代码段中所示的 MEX 终结点的其他端口指定完全限定的 URL 来解决此错误的 IP 终结点 0.0.0.0:9000 上已存在一个侦听器:

<services>  
  <service name="Microsoft.Samples.NetTcp.CalculatorService">  
    <endpoint address="calcsvc" binding ="netTcpBinding" contract="Microsoft.Samples.NetTcp.ICalculator"/>  
    <endpoint address="net.tcp://localhost:9001/servicemodelsamples/mex" binding="mexTcpBinding" contract="IMetadataExchange" />  
  </service>  
</services>  

从 WCF SOAP 应用程序调用 WCF Web HTTP 应用程序时该服务将返回以下错误:不允许使用 405 方法

调用 WCF Web HTTP 应用程序 (使用的服务xref:System.ServiceModel.WebHttpBinding和xref:System.ServiceModel.Description.WebHttpBehavior) 从 WCF 服务可能会生成以下异常:Unhandled Exception: System.ServiceModel.FaultException1[System.ServiceModel.ExceptionDetail]:远程服务器返回了意外的响应:(405) 方法不允许。 发生此异常的原因 WCF 覆盖传出xref:System.ServiceModel.OperationContext以传入xref:System.ServiceModel.OperationContext。 若要解决此问题,请在 WCF Web HTTP 服务操作内创建 xref:System.ServiceModel.OperationContextScope 。 例如:

public string Echo(string input)  
{  
    using (new OperationContextScope(this.InnerChannel))  
    {  
        return base.Channel.Echo(input);  
    }  
}  

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。