Azure函数本地运行时，队列连接字符串含%符号触发错误

核心原因 #

Azure Functions本地运行时的Microsoft.Azure.WebJobs.Host会自动解析配置中%xxx%格式的内容，将其视为环境变量占位符尝试替换。但Azure Storage生成的连接字符串里的%是URL编码字符（比如%2F对应/、%3A对应:），被误判为环境变量标记，导致解析失败。而Django不会做这类解析，因此可以正常连接。

解决方法 #

1. 转义连接字符串中的%符号
   将连接字符串里的单个%替换为两个%%，这样宿主会将其识别为普通字符而非环境变量占位符。
   示例：
   原连接字符串片段：AccountKey=abc%2Fdef%3Aghi
   转义后：AccountKey=abc%%2Fdef%%3Aghi

2. 在local.settings.json中配置转义后的字符串
   直接在local.settings.json的Values节点里填入转义后的完整连接字符串，比如：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=your-storage-account;AccountKey=abc%%2Fdef%%3Aghi;EndpointSuffix=core.windows.net",
    "FUNCTIONS_WORKER_RUNTIME": "python"
  }
}

3. 可选：通过系统环境变量配置
   如果不想修改连接字符串，也可以将完整的原始连接字符串设置为系统环境变量（比如命名为AZURE_STORAGE_CONN_STRING），然后在local.settings.json中引用：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "%AZURE_STORAGE_CONN_STRING%",
    "FUNCTIONS_WORKER_RUNTIME": "python"
  }
}

这种方式下，宿主会正确读取系统环境变量中的原始连接字符串，不会解析其中的URL编码%符号。

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