如何針對 Azure Web PubSub 事件處理程式進行疑難解答和偵錯
當 WebSocket 連線連接到 Web PubSub 服務時，服務會向已註冊的上游制定 HTTP POST 要求，並預期 HTTP 回應。 我們會以事件處理常式形式呼叫此上游，而且事件處理常式會遵循 Web PubSub CloudEvents 規格負責處理傳入事件。
在本機執行事件處理程式端點
當事件處理常式在本機執行時，無法公開存取本機伺服器。
有兩種方式可將流量路由傳送至 localhost，一種是使用 ngrok、localtunnel 或 TunnelRelay 等工具來公開可在網際網路上存取的 localhost。 另一種方式 (也就是建議的方式) 是使用 awps-tunnel，透過工具將來自 Web PubSub 服務的流量經由通道送到您的本機伺服器。
Web PubSub 本機通道工具會在幕後建立對 Web PubSub 服務的數個持續性通道連線 (我們將其視為一種伺服器連線)。 每當事件發生時，Web PubSub 服務會透過通道連線將事件訊息路由傳送至本機通道工具，而本機通道工具會改造 HTTP 要求，並將要求傳送至上游伺服器。
本機通道工具透過 Web 檢視頁面提供工作流程的生動檢視。 根據預設，Web 檢視會接聽本機連接埠 upstream port + 1000，而您可以使用命令參數 --webviewPort <your-custom-port> 定義 Web 檢視連接埠。
Web 檢視包含四個索引標籤：
- [用戶端] 索引標籤，其中提供測試 WebSocket 用戶端來連線 Web PubSub 並傳送資料。
- [Web PubSub] 索引標籤，其中提供 Web PubSub 服務的基本資訊，並內嵌已啟用的 [即時追蹤] 頁面。
- [本機通道] 索引標籤，其中列出所有透過本機通道工具送至本機伺服器的要求。
- [伺服器] 索引標籤，其中顯示本機伺服器的基本資訊。 此外，也提供內建的回應伺服器，其程式碼類似於下面所示的範例程式碼。
請遵循使用本機通道工具進行開發，以在本機安裝和執行通道工具，進而在本機開發事件處理常式伺服器。
在線偵錯事件處理程式端點
有時候您可能會有將事件傳送至已設定事件處理程式上游的問題。 典型的錯誤類型與濫用保護失敗有關， 例如、 AbuseProtectionResponseInvalidStatusCodeAbuseProtectionResponseMissingAllowedOrigin或 AbuseProtectionResponseFailed。 這類錯誤可能與上游應用程式伺服器設定相關，例如，403 狀態代碼可能與您的應用程式伺服器驗證組態相關，404 狀態代碼可能是由不一致的事件處理程式路徑設定所造成。 針對這類失敗進行疑難解答的其中一種方式，就是將濫用保護要求傳送至您設定的事件處理程式 URL，以查看其是否正常運作，例如，使用 curl 命令將濫用保護要求傳送至您設定的事件處理程式 URL https://abc.web.com/eventhandler 如下所示：
curl https://abc.web.com/eventhandler -X OPTIONS -H "WebHook-Request-Origin: *" -H "ce-awpsversion: 1.0" --ssl-no-revoke -i
此命令應該會傳回 204。
下一步
使用這些資源開始建置自己的應用程式：