Azure Durable Function调用超时失败，Azurite无数据显示

一、修复Netherite与Azurite的兼容性问题 #

Netherite对Azurite的版本和配置有特定要求，这是卡顿的核心原因：

• 升级Azurite到v3.20.0及以上版本，旧版本对Netherite依赖的存储租约、批量操作等特性支持不完善，会导致反复发起容器创建请求却失败，阻塞Orchestrator执行。
• 启动Azurite时必须添加关键参数，跳过API版本校验（Netherite使用的API版本与Azurite默认校验规则不匹配）：

  azurite --blobHost 127.0.0.1 --blobPort 10000 --queueHost 127.0.0.1 --queuePort 10001 --tableHost 127.0.0.1 --tablePort 10002 --skipApiVersionCheck
  

二、修正Durable Functions本地配置 #

检查local.settings.json中的存储相关配置，确保参数正确：

• 确认AzureWebJobsStorage指向标准Azurite连接字符串：

  "AzureWebJobsStorage": "DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;"
  

• 确保DurableTask配置项与Azurite容器前缀匹配：

  "DurableTask:HubName": "testhubname",
  "DurableTask:StorageProvider": "Netherite"
  

三、解决Storage Explorer无数据显示问题 #

• 重启Azurite和Storage Explorer，确保两者连接的是同一端口的Azurite实例。
• 在Storage Explorer中手动添加Azurite账户时，选择自定义端点而非默认的"Azure存储模拟器"：
  • Blob服务端点：http://127.0.0.1:10000/devstoreaccount1
  • 队列服务端点：http://127.0.0.1:10001/devstoreaccount1
  • 表服务端点：http://127.0.0.1:10002/devstoreaccount1
    账户名填devstoreaccount1，账户密钥使用上述连接字符串中的值。

四、排查Orchestrator执行阻塞 #

• 检查Orchestrator函数代码，确保没有同步阻塞操作（如长时间运行的同步方法），Durable Functions要求Orchestrator必须是纯异步无阻塞的。
• 启用Durable Functions日志排查错误，在local.settings.json中添加：

  "Logging:LogLevel:DurableTask": "Information",
  "Logging:LogLevel:Microsoft.Azure.WebJobs.Extensions.DurableTask": "Information"
  

  启动Function App后，查看控制台日志中Netherite初始化或容器创建的具体错误信息，针对性修复。

五、临时验证方案：切换到真实Azure Storage #

如果上述方法无效，可暂时用真实Azure Storage账户测试：

• 创建Azure Storage账户，替换local.settings.json中的AzureWebJobsStorage为真实账户连接字符串。
• 验证Durable Function本身是否正常运行，排除Azurite兼容性问题后再回头调试本地模拟器。

内容的提问来源于stack exchange，提问作者wonderful world