本文將協助你排除耐用任務排程器應用程式中常見的情況。 請在以下清單中找到您的情境,並依照連結步驟診斷並解決問題。
常見場景
- 檢查連接字串並存取 Durable Task Scheduler
- 部署持久性函數應用程式至 Azure 時出錯
- 取得此任務中心詳細資訊時發生未知錯誤
- 無法刪除資源
- 無法決定要建造的專案
- 找不到 ARM(Apple Silicon)的原生二進位檔
備註
Microsoft支援工程師可用來協助診斷應用程式的問題。 如果你看完這篇文章後仍無法診斷問題,可以到 Azure 入口網站中 Durable Task Scheduler 資源的 Help>Support + troubleshooting 區塊提出支援工單。
檢查連接字串和 Durable Task Scheduler 的存取權
當你的應用程式無法如預期運行時,請確認以下事項:
- 此連接字串的格式是正確的。
- 認證設定正確。
地方發展
檢查連接字串,其格式應為:
Endpoint=http://localhost:<port number>;Authentication=None。8080上, 所對應的連接埠號碼是必須使用的號碼。除了長期工作排程器的仿真器,也請一併確定 Azure 儲存體仿真器 Azurite 已啟動。 應用程式中與功能相關的元件需要使用Azurite。
在 Azure 上執行
檢查您的應用程式是否有環境變數
DURABLE_TASK_SCHEDULER_CONNECTION_STRING和TASKHUB_NAME。檢查
DURABLE_TASK_SCHEDULER_CONNECTION_STRING的值。 具體來說,請確認排程器端點和驗證類型是否正確。 使用時,連接字串的格式應如下:-
使用者指派的受控識別:
Endpoint={scheduler endpoint};Authentication=ManagedIdentity;ClientID={client id},其中client id是身分識別的用戶端標識符。 -
系統指派的受控識別:
Endpoint={scheduler endpoint};Authentication=ManagedIdentity
-
使用者指派的受控識別:
若身分識別需要存取特定工作中樞或排程器,該身分識別必須獲得必要的角色型存取控制 (RBAC) 權限。
- 存取儀表板時,請確定權限指派到自己的身分識別 (電子郵件)。
如果使用使用者指派的受控識別,請確定已 將身分識別指派給您的應用程式。
在部署 Durable Functions 應用程式至 Azure 時出錯
如果你的部署因 Visual Studio Code Encountered an error (ServiceUnavailable) from host runtime 等錯誤而失敗,請先檢查應用程式,確保所需的 environment 變數 設定正確。 然後重新部署您的應用程式。 如果看到「功能載入」錯誤,請按 重新整理 按鈕。
擷取此任務中樞細節時發生未知錯誤
如果在長期工作排程器儀表板上收到 Unknown error retrieving details of this task hub 錯誤,原因可能如下:
您的身分識別 (電子郵件) 並未獲得該工作中樞要求的權限。 依照指示 授與許可權,然後再次存取儀錶板。
您的工作中樞已刪除。
無法刪除資源
在刪除排程資源之前,必須先刪除其所有任務中心。 如果您尚未這麼做,您會收到下列錯誤訊息:
{
"error": {
"code": "CannotDeleteResource",
"message": "Cannot delete resource while nested resources exist. Some existing nested resource IDs include: 'Microsoft.DurableTask/schedulers/YOUR_SCHEDULER/taskhubs/YOUR_TASKHUB'. Please delete all nested resources before deleting this resource."
}
}
為了解決這個問題,可以在排程器中列出任務樞紐並刪除它們:
# List all task hubs in the scheduler
az durabletask taskhub list --resource-group RESOURCE_GROUP_NAME --scheduler-name SCHEDULER_NAME
# Delete each task hub
az durabletask taskhub delete --resource-group RESOURCE_GROUP_NAME --scheduler-name SCHEDULER_NAME --name TASKHUB_NAME
所有任務中心都被刪除後,再試一次刪除排程資源。
無法判斷要建置的專案
如果啟動 Azurite 之後,您遇到錯誤: : “Can't determine Project to build. Expected 1 .csproj or .fsproj but found 2”
- 刪除應用程式中的 bin 和 obj 目錄。
- 請嘗試再次執行
func start。
找不到 ARM(Apple Silicon)的原生二進位檔
如果你發現 gRPC 錯誤,因為找不到原生 ARM 二進位檔(例如 Apple silicon Mac 上的 M1、M2 等),請在檔案 extensions.csproj 中加入以下變通方法:
- 新增
Contrib.Grpc.Core.M1的套件參考。 - 新增一個自訂的後建置目標,將 ARM64 gRPC 原生函式庫複製到正確的輸出目錄。
將以下ItemGroup和Target元素新增至extensions.csproj中:
<!-- Workaround for gRPC issues on ARM (Apple silicon) devices -->
<ItemGroup>
<PackageReference Include="Contrib.Grpc.Core.M1" Version="2.41.0" />
</ItemGroup>
<Target Name="CopyGrpcNativeAssetsToOutDir" AfterTargets="Build">
<ItemGroup>
<NativeAssetToCopy Condition="$([MSBuild]::IsOSPlatform('OSX'))" Include="$(OutDir)runtimes/osx-arm64/native/*"/>
</ItemGroup>
<Copy SourceFiles="@(NativeAssetToCopy)" DestinationFolder="$(OutDir).azurefunctions/runtimes/osx-arm64/native"/>
</Target>