容器化Azure Durable Functions时无法解析AzureWebJobsStorage连接

问题描述 #

本地运行正常的Azure Durable Functions应用，容器化运行镜像时抛出错误：

Unable to resolve the Azure Storage connection named 'AzureWebJobsStorage'.

已尝试以下操作但未解决问题：

• 在local.settings.json中配置了"AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=..."；
• 在Azure应用设置中配置了相同连接字符串的AzureWebJobsStorage和AzureWebJobsDashboard；
• 在host.json中添加了以下配置：

"extensions": {
  "durableTask": {
    "hubName": "MyTaskHub",
    "storageProvider": {
      "connectionStringName": "AzureWebJobsStorage"
    }
  }
},

• 检查过两个JSON文件的语法（缩进、逗号），确认无误；
• 重启过函数应用；
• 查阅过多个技术论坛和文档，找到的解决方案均为上述已尝试操作。

补充说明：因local.settings.json在.dockerignore中，容器内无法默认读取，运行镜像时已通过卷挂载该文件，但问题依然存在。

解决方案 #

1. 优先使用环境变量传递连接字符串 #

Azure Functions容器运行时优先读取环境变量，而非local.settings.json文件。直接在启动容器时传入环境变量：

docker run -e AzureWebJobsStorage="DefaultEndpointsProtocol=https;AccountName=..." your-image-tag

或者在Dockerfile中预先设置环境变量：

ENV AzureWebJobsStorage="DefaultEndpointsProtocol=https;AccountName=..."

2. 确认卷挂载路径正确性 #

Linux版Azure Functions容器默认从/home/site/wwwroot/local.settings.json读取配置文件，确保挂载路径匹配：

docker run -v /本地路径/local.settings.json:/home/site/wwwroot/local.settings.json your-image-tag

3. 验证连接字符串有效性及存储账户权限 #

• 检查连接字符串是否完整，确认包含AccountKey或有效的SAS Token；
• 检查存储账户防火墙规则，确保容器所在网络（或公网）有权限访问该存储账户。

4. 检查扩展与Runtime版本兼容性 #

确认项目中Durable Functions扩展包版本与容器基础镜像的Functions Runtime版本兼容。建议更新扩展包至最新稳定版，或使用对应版本的官方基础镜像。

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