WCF 實戰 (9)：使用 tcpTrace 進行 SOAP 訊息追蹤 — 中介節點原理與實操指南

一、tcpTrace 工具原理：監聽/轉發中介節點

tcpTrace 本質是一個 Listening/Forwarding Proxy。啟動時指定 Listening Port (如 8080) 與 Destination Host:Port (真實服務 8888)。所有發往 8080 的 HTTP Request 被攔截、顯示、再轉發至 8888；Response 同理回傳。這在 SOAP 架構中屬於 Intermediary Node 角色。

二、WCF 客戶端接入：ClientViaBehavior

需讓客戶端將訊息發送至 tcpTrace (8080)，但 SOAP Header To 仍指向真實服務 (8888)。WCF 提供 <clientVia> 端點行為實現此目的。

服務端設定 (真實服務 8888)

<endpoint address="https://localhost:8888/Calculator" binding="wsHttpBinding" contract="...ICalculator" />

客戶端設定 (經由 tcpTrace 8080)

<endpointBehaviors>
  <behavior name="traceBehavior">
    <clientVia viaUri="https://localhost:8080/Calculator" />
  </behavior>
</endpointBehaviors>

<client>
  <endpoint address="https://localhost:8888/Calculator"
            behaviorConfiguration="traceBehavior"
            binding="wsHttpBinding" contract="...ICalculator" name="default" />
</client>

三、實操步驟與效果

1. 啟動 tcpTrace，設定 Listening Port=8080, Destination=localhost:8888，可選擇 Log 檔案。
2. 啟動服務 (8888)、客戶端。
3. tcpTrace 視窗即時顯示 Request/Response 完整 SOAP 封包：

4. Log 檔案完整記錄所有往返訊息：

四、進階應用

• 負載平衡：Intermediary 可根據規則轉發至不同後端。
• 安全稽核：記錄所有 SOAP 交換供合規審查。
• 效能分析：計算序列化/傳輸/處理各階段耗時。

總結

tcpTrace + ClientViaBehavior 是 WCF 開發期 SOAP 除錯的黃金組合，零侵入式、支援雙向追蹤、可持久化 Log，強烈建議納入開發工具箱。