本地运行进程内Azure Function时无法读取local.settings.json配置值

1. 核对配置名拼写 #

• 报错提示的CosmosDbConection存在明显拼写错误（缺少字母n），需确认function.json中CosmosDB的connection属性值，与local.settings.json里的配置键名完全一致，包括大小写（Windows本地运行不区分大小写，但严格匹配可避免后续部署问题）。

2. 校验local.settings.json结构 #

• 确保配置项位于Values节点下，正确格式示例：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "xxx",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "CosmosDbConnection": "你的Cosmos DB连接字符串"
  }
}

• 检查JSON语法是否合法，比如是否有遗漏的逗号、不匹配的引号，可通过在线JSON校验工具验证。

3. 确认.csproj文件复制配置 #

• 检查项目文件中local.settings.json的复制属性设置，确保编译时能同步到输出目录：

<ItemGroup>
  <None Update="local.settings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>Never</CopyToPublishDirectory>
  </None>
</ItemGroup>

• 重点确认CopyToOutputDirectory是否设为PreserveNewest或Always，若为Never会导致输出目录无该文件。

4. 检查本地调试环境配置加载 #

• 使用Visual Studio调试时，右键项目→属性→调试，确认勾选启用Azure Functions核心工具，且未手动覆盖配置项。
• 用Azure Functions Core Tools运行时，务必在项目根目录执行func start命令，核心工具默认读取根目录的local.settings.json。
• 清除项目的bin/obj目录后重新编译，避免旧配置文件残留干扰。

5. 排查配置加密问题 #

• 若local.settings.json中IsEncrypted设为true，本地运行无法读取加密配置，需改为false；若之前加密过，可执行func settings decrypt命令解密。

6. 验证连接字符串有效性 #

• 即使配置名匹配，也要确认Cosmos DB连接字符串本身是否正确，比如是否包含有效的账户名、密钥、数据库信息，可尝试用该字符串直接连接Cosmos DB测试连通性。

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