.Net Wcf Web Services

WCFウェブサービスの例外をデバッグするためのヒントと必要なツール

Windows Communication Foundation (WCF) サービスを作成することはやりがいがありますが、しばしば特有の課題が伴います。開発者が直面する一般的な問題の一つは、サービスエンドポイントでの例外処理です。以下のようなフォルトメッセージを受け取ったことがあるなら、そのフラストレーションを理解しているでしょう。

フォルトメッセージ:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <s:Fault>
      <faultcode 
            xmlns:a="http://schemas.microsoft.com/ws/2005/05/addressing/none">
            a:ActionNotSupported
      </faultcode> 
      <faultstring xml:lang="en-GB">
            The message with Action '' cannot be processed at the receiver,
            due to a ContractFilter mismatch at the EndpointDispatcher. 
            This may be because of either a contract mismatch (mismatched
            Actions between sender and receiver) or a binding/security
            mismatch between the sender and the receiver. Check that sender
            and receiver have the same contract and the same binding
            (including security requirements, e.g. Message, Transport, None).
      </faultstring> 
    </s:Fault>
  </s:Body>
</s:Envelope>

このエラーメッセージは、いくつかの根本的な問題を示しています。これらのWCFのエラーを効果的にデバッグし、サービスがスムーズに動作するようにする方法について掘り下げてみましょう。

問題の理解

デバッグのヒントに飛び込む前に、直面する可能性のある問題の主要な要素を分解してみましょう。

  • 契約フィルタの不一致: WCFサービスの契約で設定されている期待されるアクションと、クライアントから送信されるアクションとの間に違いがあるときに発生します。
  • バインディング/セキュリティの不一致: クライアントとサービスがバインディングメソッド（例：HTTP、TCPなど）やセキュリティ要件（メッセージレベルまたはトランスポートレベルのセキュリティのような）について一致しない場合にこの問題が発生します。

これらの潜在的な不一致について知識を持つことは、問題の源を特定するのに役立ちます。

効果的なデバッグのためのヒント

例外に効果的に対処するために、以下の戦略を検討してください。

1. SvcTraceViewer.exeを活用する

あなたの手元にある最も強力なツールの一つはSvcTraceViewer.exeで、.NET Frameworkに含まれています。このツールを使用することで、

  • WCFサービスコールのトレース: サービスコール中に何が起こっているかを洞察し、詳細なエラーメッセージや設定をキャプチャできます。
  • トレースデータの可視化: ログされたメッセージを簡単に分析し、エラーが発生している場所と理由を理解できます。

詳細な使用手順については、MSDNのSvcTraceViewerの概要を確認してください。

2. WCFトレースとメッセージロギングを有効にする

問題を効果的に診断するために、WCFサービスの構成でトレースとメッセージロギングを有効にします：

  • Web.configに以下を追加:
<system.diagnostics>
  <sources>
    <source name="System.ServiceModel" switchValue="Information, ActivityTracing">
      <listeners>
        <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData="WCFLog.svclog" />
      </listeners>
    </source>
  </sources>
</system.diagnostics>
  • 記録された .svclog ファイルを確認し、クライアントとサービス間のリクエストおよびレスポンスの詳細なトレースを確認します。

3. 構成設定を一致させる

クライアントの設定がサーバーの期待に一致するか確認します：

  • サービスバインディング: クライアントとサーバーが同じバインディング設定を使用していることを確認します。Web.configやApp.configファイルのbinding属性を確認してください。
  • 契約: 両方のエンドが同じデータ契約およびサービス契約の定義を使用していることを確認し、定義されているアクションも含めて一致させます。

4. デバッグツールを使用する

SvcTraceViewerに加えて、次のデバッグ技法も検討してください：

  • Visual Studioでのデバッグ: WCFサービスホストプロセスにデバッガーをアタッチします。これにより、問題が発生する場所をステップバイステップで確認できます。
  • Try-Catchブロック: 重要なコードセクションの周りにtry-catchブロックを実装し、例外を適切に処理し、詳細なエラー情報をログに記録します。

結論

WCFウェブサービスの例外をデバッグすることは困難な場合がありますが、正しいツールを活用し、体系的なトラブルシューティング方法に従うことで、デバッグプロセスを大幅に緩和できます。SvcTraceViewer.exeの強力な機能を活用し、他のデバッグ技法と組み合わせて、あなたのトラブルシューティングスキルを向上させましょう。

コーディングで直面するすべての課題は、学び、成長する機会です。楽しいデバッグを！