本地运行绑定Cosmos DB的Azure Functions无法解析ConnectionStringSetting报错

根本原因 #

• IntelliJ运行Azure Functions时的配置优先级问题：Azure Functions核心工具加载配置的优先级为 系统环境变量 > 运行配置自定义环境变量 > local.settings.json配置，如果IntelliJ的函数运行配置没有开启加载local.settings.json的开关，函数运行时就无法读取该文件内的配置项。
• local.settings.json格式错误：配置项必须放在文件的Values节点下才会被识别为运行时环境变量，直接写在根节点的配置会被忽略；另外JSON格式不合法（多余逗号、中文符号等）也会导致配置加载失败。
• git忽略规则导致配置不同步：Azure Functions项目默认的.gitignore规则会排除local.settings.json文件，你本地修改的配置不会被提交到代码库，同事拉取代码后本地没有该配置文件，自然会触发报错，只能手动加环境变量绕过。你本地之前报错自行消失，大概率是某次运行时IDE意外加载到了缓存的配置，或是你之前添加过临时环境变量未清理。

修复步骤 #

• 确认local.settings.json格式符合要求，参考示例：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "java",
    "CosmosDBAttribute.ConnectionStringSetting": "你的Cosmos DB连接字符串"
  }
}

• 统一IntelliJ运行配置：所有开发人员打开函数的运行/调试配置面板，在Azure Functions配置页勾选「将local.settings.json中的值导入为环境变量」（不同版本Azure插件表述略有差异，找到对应加载本地配置的选项即可），确保运行时优先读取项目内的配置文件。
• 解决配置同步问题：在代码库提交local.settings.json.template模板文件，所有同事拉取代码后复制为local.settings.json并填入对应配置；如果是内部开发环境无敏感信息，也可以直接把local.settings.json从.gitignore中移除后提交。
• 若Azure云端也偶发该问题，确认应用设置中的配置键名和代码里connectionStringSetting的取值完全一致，无大小写、拼写差异。

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