Sdílet prostřednictvím

Rychlý start pro řešení potíží s WCF

Toto téma uvádí řadu známých problémů, na které zákazníci narazili při vývoji klientů a služeb WCF. Pokud problém, na který narazíte, není v tomto seznamu, doporučujeme nakonfigurovat trasování pro vaši službu. Tím se vygeneruje trasovací soubor, který můžete zobrazit v prohlížeči trasovacích souborů a získat podrobné informace o výjimkách, ke kterým může dojít v rámci služby. Další informace o konfiguraci trasování najdete v tématu: Konfigurace trasování. Další informace o prohlížeči trasovacích souborů naleznete zde: Nástroj Service Trace Viewer (SvcTraceViewer.exe).

  1. Po instalaci systému Windows 7 a IIS se při pokusu o přechod na službu WCF zobrazí následující chybová zpráva: Chyba HTTP 404.3 – Nenalezena

    Chyba HTTP 404.3 – Stránka, kterou požadujete, se nedá obsluhovat kvůli konfiguraci rozšíření. Pokud je stránka skriptem, přidejte obslužnou rutinu. Pokud se má soubor stáhnout, přidejte mapu MIME. Podrobné informace o modulové chybě StaticFileModule.

  2. Někdy se mi při druhém požadavku zobrazí výjimka MessageSecurityException, pokud je můj klient nějakou dobu nečinný po prvním požadavku. Co se děje?

  3. Moje služba začne odmítat nové klienty po asi 10 klientech, kteří s ním pracují. Co se děje?

  4. Můžu načíst konfiguraci služby z jiného umístění než konfigurační soubor aplikace WCF?

  5. Moje služba a klient fungují skvěle, ale nemůžu je dostat do práce, když je klient na jiném počítači? Co se děje?

  6. Když vyvolám FaultException<Exception> tam, kde typem je výjimka, na straně klienta vždy obdržím obecný typ FaultException, nikoli ten specifický. Co se děje?

  7. Zdá se, že jednosměrné a žádost-odpovědní operace mají přibližně stejnou rychlost, když odpověď neobsahuje žádná data. Co se děje?

  8. Používám ve své službě certifikát X.509 a získám výjimku System.Security.Cryptography.CryptographicException. Co se děje?

  9. Změnil jsem první parametr operace z velkých písmen na malá písmena; teď můj klient vyvolá výjimku. Co se děje?

  10. Používám jeden ze svých trasovacích nástrojů a dostávám výjimku typu EndpointNotFoundException. Co se děje?

  11. Při volání webové aplikace HTTP WCF z aplikace WCF SOAP vrátí služba následující chybu: 405 Metoda Není povolena.

Jaká je základní adresa? Jak souvisí s adresou koncového bodu?

Po instalaci systému Windows 7 a IIS se při pokusu o přechod na službu WCF zobrazí následující chybová zpráva: Chyba HTTP 404.3 – Nenalezena

Celá chybová zpráva zní:

Chyba HTTP 404.3 – Stránka, kterou požadujete, se nedá obsluhovat kvůli konfiguraci rozšíření. Pokud je stránka skriptem, přidejte obslužnou rutinu. Pokud se má soubor stáhnout, přidejte mapu MIME. Podrobné informace o modulové chybě StaticFileModule.

K této chybové zprávě dochází v případě, že v Ovládacích panelech není explicitně nastavena aktivace HTTP služby Windows Communication Foundation. Chcete-li tuto možnost nastavit na Ovládací panely, klepněte na položku Programy v levém dolním rohu okna. Klikněte na Zapnout nebo vypnout funkce Systému Windows. Rozbalte rozhraní Microsoft .NET Framework 3.5.1 a vyberte aktivace HTTP služby Windows Communication Foundation.

Někdy se mi při druhém požadavku zobrazí výjimka MessageSecurityException, pokud je můj klient nějakou dobu nečinný po prvním požadavku. Co se děje?

Druhý požadavek může selhat především ze dvou důvodů: (1) vypršel časový limit relace nebo (2) webový server, který je hostitelem služby, je recyklován. V prvním případě je relace platná, dokud nevypršel časový limit služby. Pokud služba neobdrží požadavek od klienta během časového období zadaného ve vazbě služby (ReceiveTimeout), služba ukončí relaci zabezpečení. Následné zprávy klienta mají za následek MessageSecurityException. Klient musí znovu vytvořit zabezpečenou relaci se službou, aby mohl odesílat budoucí zprávy, nebo použít token kontextu stavové bezpečnosti. Stavové tokeny bezpečnostního kontextu také umožňují, aby zabezpečené relace přežily, když je webový server recyklován. Další informace o použití stavových zabezpečených kontextových tokenů v zabezpečené relaci naleznete v tématu Postupy: Vytvoření tokenu kontextu zabezpečení pro zabezpečenou relaci. Případně můžete vypnout zabezpečené relace. Pokud používáte <vazbu wsHttpBinding>, můžete nastavit vlastnost establishSecurityContext na false pro zakázání zabezpečených relací. Pokud chcete zakázat zabezpečené relace pro jiné vazby, musíte vytvořit vlastní vazbu. Podrobnosti o vytvoření vlastní vazby naleznete v tématu Postupy: Vytvoření vlastní vazby pomocí SecurityBindingElement. Než použijete některou z těchto možností, musíte porozumět požadavkům vaší aplikace na zabezpečení.

Moje služba začne odmítat nové klienty po asi 10 klientech, kteří s ním pracují. Co se děje?

Ve výchozím nastavení mohou mít služby pouze 10 souběžných relací. Proto pokud vazby služby používají relace, služba přijímá nová klientská připojení, dokud nedosáhne tohoto čísla, po kterém odmítne nová připojení klientů, dokud jedna z aktuálních relací neskončí. Více klientů můžete podporovat mnoha způsoby. Pokud vaše služba nevyžaduje relace, nepoužívejte vazbu závislou na relaci. (Další informace naleznete v tématu Použití relací.) Další možností je zvýšit limit relace změnou hodnoty MaxConcurrentSessions vlastnosti na číslo odpovídající vašim okolnostem.

Můžu načíst konfiguraci služby z jiného umístění než konfigurační soubor aplikace WCF?

Ano, ale musíte vytvořit vlastní ServiceHost třídu, která přepíše metodu ApplyConfiguration . Uvnitř této metody můžete nejprve zavolat základní načtení konfigurace (pokud chcete načíst také standardní konfigurační informace), ale můžete také zcela nahradit systém načítání konfigurace. Pokud chcete načíst konfiguraci z konfiguračního souboru, který se liší od konfiguračního souboru aplikace, musíte konfigurační soubor analyzovat sami a načíst konfiguraci.

Následující příklad kódu ukazuje, jak přepsat metodu ApplyConfiguration a přímo nakonfigurovat koncový bod.

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;  
    }  
}

Moje služba a klient fungují skvěle, ale nemůžu je dostat do práce, když je klient na jiném počítači? Co se děje?

V závislosti na výjimce může dojít k několika problémům:

  • Možná budete muset změnit adresy koncového bodu klienta na název hostitele místo na "localhost".

  • Možná budete muset otevřít port pro aplikaci. Podrobnosti najdete v pokynech k bráně firewall z ukázek sady SDK.

  • Další možné problémy najdete v tématu Ukázky spuštění ukázek Windows Communication Foundation.

  • Pokud váš klient používá přihlašovací údaje systému Windows a výjimka je SecurityNegotiationException, nakonfigurujte protokol Kerberos následujícím způsobem.

    1. Přidejte přihlašovací údaje identity do elementu koncového bodu v souboru App.config klienta:

      <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. Spusťte službu v místním prostředí pod účtem System nebo NetworkService. Spuštěním tohoto příkazu můžete vytvořit příkazové okno pod systémovým účtem:

      at 12:36 /interactive "cmd.exe"

    3. Hostujte službu v internetové informační službě (IIS), která ve výchozím nastavení používá účet hlavního názvu služby (SPN).

    4. Zaregistrujte nový hlavní název služby (SPN) v doméně pomocí SetSPN. Abyste to mohli udělat, musíte být správcem domény.

Další informace o protokolu Kerberos naleznete v tématu Koncepty zabezpečení používané ve WCF a:

Když vyvolám FaultException<Exception> tam, kde typem je výjimka, na straně klienta vždy obdržím obecný typ FaultException, nikoli ten specifický. Co se děje?

Důrazně doporučujeme vytvořit vlastní datový typ chyby a deklarovat, že se jedná o podrobný typ ve smlouvě o chybě. Důvodem je použití systémových typů výjimek:

  • Vytvoří závislost typu, která odebere jednu z největších silných stránek aplikací orientovaných na služby.

  • Nelze se spolehnout na to, že budou výjimky serializovány standardním způsobem. Některé – třeba SecurityException– nemusí být vůbec serializovatelné.

  • Zveřejňuje interní podrobnosti implementace klientům. Další informace naleznete v tématu Určení a zpracování chyb v kontraktech a službách.

Pokud ale ladíte aplikaci, můžete serializovat informace o výjimce a vrátit je klientovi pomocí ServiceDebugBehavior třídy.

Zdá se, že jednosměrné a žádost-odpovědní operace mají přibližně stejnou rychlost, když odpověď neobsahuje žádná data. Co se děje?

Určení, že operace je jedním ze způsobů, znamená to, že kontrakt operace přijímá vstupní zprávu a nevrací výstupní zprávu. Ve WCF se všechna volání klientů vrátí, když jsou odchozí data zapsána na drát, nebo dojde k výjimce. Jednosměrné operace fungují stejným způsobem a mohou vyvolat výjimku, pokud službu nelze nalézt, nebo blokovat, pokud není služba připravena přijímat data ze sítě. Ve WCF to obvykle vede k jednosměrným voláním vracející se klientovi rychleji než žádost-odpověď; ale jakákoli podmínka, která zpomaluje odesílání odchozích dat přes síť, zpomaluje jednosměrné operace i operace odpovědi na požadavky. Další informace naleznete v tématu One-Way Services a přístup ke službám pomocí klienta WCF.

Používám ve své službě certifikát X.509 a získám výjimku System.Security.Cryptography.CryptographicException. Co se děje?

K tomu obvykle dochází po změně uživatelského účtu, pod kterým běží pracovní proces služby IIS. Pokud například v systému Windows XP změníte výchozí uživatelský účet, pod kterým Aspnet_wp.exe běží z ASPNET na vlastní uživatelský účet, může se zobrazit tato chyba. Pokud používáte privátní klíč, proces, který ho používá, bude muset mít oprávnění pro přístup k souboru, který tento klíč ukládá.

V takovém případě musíte poskytnout přístupová práva ke čtení účtu procesu pro soubor obsahující privátní klíč. Pokud je například pracovní proces služby IIS spuštěný pod účtem Bob, budete muset Bobovi udělit přístup ke čtení k souboru obsahujícímu privátní klíč.

Další informace o tom, jak udělit správnému uživatelskému účtu přístup k souboru, který obsahuje privátní klíč pro konkrétní certifikát X.509, naleznete v tématu Postupy: Zpřístupnění certifikátů X.509 WCF.

Změnil jsem první parametr operace z velkých písmen na malá písmena; teď můj klient vyvolá výjimku. Co se děje?

Hodnoty názvů parametrů v podpisu operace jsou součástí kontraktu a rozlišují velká a malá písmena. System.ServiceModel.MessageParameterAttribute Atribut použijte, pokud potřebujete rozlišovat mezi názvem místního parametru a metadaty popisovanými operací pro klientské aplikace.

Používám jeden ze svých trasovacích nástrojů a dostávám výjimku typu EndpointNotFoundException. Co se děje?

Pokud používáte trasovací nástroj, který není systémem poskytovaný mechanismus trasování WCF a obdržíte EndpointNotFoundException zprávu, která indikuje, že došlo k neshodě filtru adres, musíte použít ClientViaBehavior třídu k nasměrování zpráv do nástroje trasování a nechat nástroj tyto zprávy přesměrovat na adresu služby. ClientViaBehavior Třída změní hlavičku Via adresování tak, aby určila další síťovou adresu odděleně od konečného příjemce, kterého určuje hlavička To adresování. V takovém případě ale neměňte adresu koncového bodu, která se používá k vytvoření To hodnoty.

Následující příklad kódu ukazuje ukázkový konfigurační soubor klienta.

<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>

Jaká je základní adresa? Jak souvisí s adresou koncového bodu?

Základní adresa je kořenová adresa třídy ServiceHost . Pokud do konfigurace své služby přidáte třídu ServiceMetadataBehavior, načtou se popisy jazyka WSDL (Web Services Description Language) pro všechny koncové body, které hostitel publikuje, ze základní adresy HTTP, a také z jakékoli relativní adresy přidané k chování metadat, s příponou "?wsdl". Pokud znáte ASP.NET a IIS, je základní adresa ekvivalentní virtuálnímu adresáři.

Sdílení portu mezi koncovým bodem služby a koncovým bodem mex pomocí NetTcpBinding

Pokud zadáte základní adresu pro službu, jako je net.tcp://MyServer:8080/MyService, a přidáte následující koncové body:

<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>

A pokud upravíte jedno z nastavení NetTcpBinding, jak je znázorněno v následujícím fragmentu konfigurace:

<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>

Zobrazí se chyba podobná následující: Neošetřená výjimka: System.ServiceModel.AddressAlreadyInUseException: Již existuje posluchač na koncovém bodu IP adresy 0.0.0.0:9000. Tuto chybu můžete obejít zadáním plně kvalifikované adresy URL s jiným portem pro koncový bod MEX, jak je znázorněno v následujícím fragmentu konfigurace:

<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>

Při volání webové aplikace HTTP WCF z aplikace WCF SOAP vrátí služba následující chybu: 405 Metoda Není povolena.

Volání webové HTTP aplikace WCF (služba, která používá WebHttpBinding a WebHttpBehavior) ze služby WCF může vyvolat následující výjimku: Unhandled Exception: System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]: The remote server returned an unexpected response: (405) Method Not Allowed. K této výjimce dochází, protože WCF přepíše odchozí OperationContext příchozím OperationContext. Chcete-li tento problém vyřešit, vytvořte OperationContextScope v rámci operace webové služby HTTP WCF. Například:

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

Viz také

  • Ladění chyb ověřování systému Windows