المهارات azure-messaging

📦

azure-messaging

Name: azure-messaging
Author: microsoft

آمن

疑難排解 Azure 傳訊 SDK 問題

此技能協助開發人員診斷並修正 Azure Event Hubs 和 Service Bus SDK 問題,包括連線失敗、驗證錯誤、訊息處理問題,以及 Python、Java、JavaScript 和 .NET SDK 之間的設定問題。

يدعم: Claude Codex Code(CC)

🥈 77 فضي

تنزيل ZIP المهارة

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

فعّل وابدأ الاستخدام

اختبرها

استخدام "azure-messaging". EventHubsException: The connection was closed unexpectedly when receiving events

النتيجة المتوقعة:

此錯誤通常表示 EventProcessorClient 已被處置,或 AMQP 連線已遺失。常見原因:1) 事件處理常式中未處理的例外狀況 - 請確保已攔截所有例外狀況。2) 處理序損毀 - 請在穩定的環境中託管您的處理器。3) 網路中斷 - 請實作重試邏輯。請查看我們的文件以了解適當的事件處理常式實作和連線復原模式。

استخدام "azure-messaging". Service Bus message lock lost immediately after processing

النتيجة المتوقعة:

如果在以下情況,可能會發生訊息鎖定遺失:1) 您在非同步處理完成之前完成訊息 - 請使用 await。2) 處理常式擲回未處理的例外狀況。3) 鎖定期間對於您的處理時間而言太短。解決方案:透過 QueueDescription.LockDuration 增加鎖定期間、在處理常式中實作 try-catch,並考慮使用 PeekLock 模式搭配明確的完成/放棄。

التدقيق الأمني

آمن

v1 • 2/22/2026

This is a Microsoft-official troubleshooting reference skill containing only documentation and example commands for debugging Azure Event Hubs and Service Bus SDK issues. All static findings are false positives: code fences (backticks) are markdown examples, URLs point to official Microsoft documentation, and diagnostic commands are standard troubleshooting tools. No executable code or malicious patterns detected.

الملفات التي تم فحصها

599

الأسطر التي تم تحليلها

النتائج

إجمالي عمليات التدقيق

لا توجد مشكلات أمنية

تم تدقيقه بواسطة: claude

درجة الجودة

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

100

الأمان

الامتثال للمواصفات

ماذا يمكنك بناءه

修正 Event Hub 連線失敗

開發人員從應用程式連線到 Azure Event Hubs 時遇到連線逾時或驗證錯誤

解決 Service Bus 訊息處理問題

工程師處理 Azure Service Bus 中的訊息鎖定遺失錯誤、無效信件佇列問題或工作階段處理問題

為生產環境設定 Event Processor

團隊使用適當的檢查點和重試設定,最佳化其 Event Hub 取用者應用程式以獲得高輸送量

جرّب هذه الموجهات

基本 Event Hub 錯誤協助

我在使用 Azure Event Hubs 時收到此錯誤:[ERROR_MESSAGE]。請協助我了解其含義及修正方法。

Service Bus 驗證問題

我的 Service Bus 用戶端因未經授權的存取而失敗。我在 [LANGUAGE] SDK 中使用 [AUTH_METHOD]。請檢查我的設定並建議修正方式。

連線疑難排解

我的 Azure 傳訊用戶端無法連線。錯誤為 [ERROR]。請協助我疑難排解連線問題,包括防火牆和網路設定。

效能最佳化

我想要最佳化我的 Event Hub 取用者以獲得高輸送量。目前設定:[DESCRIBE_CURRENT_CONFIG]。請協助我調整重試、預先擷取和檢查點設定。

أفضل الممارسات

將 EventHubClient 視為單一實例 - 為每個作業建立新的用戶端會導致通訊端耗盡和效能問題
使用 SDK 重試選項設定適當的重試原則,以正常處理暫時性失敗
使用偵錯/詳細資訊層級啟用 SDK 記錄,以擷取詳細的診斷資訊進行疑難排解

تجنب

請勿為每個訊息或作業建立新的用戶端實例 - 請在整個應用程式中重複使用相同的用戶端
除非您有特定需求,否則請避免停用重試原則 - 暫時性失敗在雲端傳訊中很常見
請勿忽略例外狀況類型 - 不同的失敗原因需要不同的處理策略

الأسئلة المتكررة

此技能支援哪些語言?

此技能涵蓋 .NET、Java、JavaScript/TypeScript 和 Python 中 Azure Event Hubs 和 Service Bus SDK 的疑難排解指引。

此技能是否會建立 Event Hubs 或 Service Bus 資源?

否,此技能用於疑難排解現有資源。請使用 azure-prepare 技能來建立和管理 Azure 傳訊資源。

如何啟用詳細資訊記錄以進行偵錯?

為您的 SDK 設定適當的環境變數或設定。針對 .NET,請設定 EventHubClientOptions。針對 Python,請設定 AZURE_LOG_LEVEL。針對 JavaScript,請使用 DEBUG 環境變數。

為什麼我會收到配額超過錯誤?

這通常表示每個取用者群組有太多並行讀取器。每個取用者群組最多允許 5 個並行讀取器。請減少取用者數目或使用不同的取用者群組。

如何設定 WebSocket 連線?

為您的 SDK 使用 WebSocket 傳輸類型:.NET 使用 EventHubsTransportType.AmqpWebSockets,Java 使用 AmqpTransportType.AMQP_WEB_SOCKETS,Python 使用 TransportType.AmqpOverWebsocket。

什麼是檢查點?如何設定它?

檢查點追蹤最後處理的事件位置。搭配 EventProcessorClient 使用 Azure Blob Storage。設定 BlobContainerClient,處理器將會自動管理分割區擁有權和檢查點進度。