Azure Functions v3 BlobTrigger Connection属性分层配置命名规则问题

这是Azure Functions v3在Windows本地运行场景下的已知适配问题：

• Azure Functions v3的本地运行时读取local.settings.json配置时，仅支持冒号:作为分层键的分隔符，不会自动将双下划线__识别为分层分隔符，所以用__作为分隔符时会提示找不到配置
• 双下划线__的分隔符仅在运行时读取系统环境变量时会被识别成分层分隔符，这个逻辑是.NET Core自带的配置规则，而v3本地触发器的绑定配置读取逻辑没有把local.settings.json的键做__到:的转换
• 你看到的构建警告是Azure Functions SDK的跨平台兼容提示：因为Linux、macOS等系统的环境变量不支持冒号字符，所以SDK检测到Connection值包含冒号时就会抛出警告，该警告不影响本地Windows运行，但部署到非Windows环境时会直接失效

• 优先选择：双端兼容配置方案
  代码中的ConnectionName常量统一使用双下划线__作为分隔符，保证跨平台兼容，同时消除构建警告。本地local.settings.json的Values节点下同时配置两种分隔符的同名键，值设置为同一个存储连接字符串即可：

  {
    "IsEncrypted": false,
    "Values": {
      "AzureWebJobsStorage": "你的默认存储连接串",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "自定义分层前缀:Connection": "你的Blob存储连接串",
      "自定义分层前缀__Connection": "你的Blob存储连接串"
    }
  }
  

  这种方案下本地运行时会自动读取冒号分隔的配置，部署到云端时只需要配置双下划线分隔的环境变量即可，两边都能正常运行，不需要额外修改代码。
• 次选方案：升级Functions运行时版本
  将项目的AzureFunctionsVersion从v3升级到v4及以上版本，v4版本的本地运行时已经修复了local.settings.json对双下划线分隔符的识别问题，代码和配置统一使用__作为分隔符即可同时适配本地与云端环境，也不会产生构建警告。
• 临时方案：屏蔽构建警告（不推荐）
  如果暂时不能调整配置也无法升级版本，可以在项目文件(.csproj)中添加对应警告编号的抑制规则，屏蔽Connection值包含冒号的构建警告。但要注意部署到非Windows环境时，需要手动将配置的分隔符替换为双下划线，否则会出现配置读取失败的问题。

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