Azure Function V4 .NET Isolated连接Cosmos DB变更提要失败排查

问题场景 #

参考V3进程内Azure Function教程配置CosmosDBTrigger：

[CosmosDBTrigger(databaseName: "Test",
            collectionName: "collection1",
            ConnectionStringSetting = "ConnectionString",
            LeaseCollectionName = "lease",                
            LeaseCollectionPrefix = "UpdateLocation-",
            CreateLeaseCollectionIfNotExists = true)]

但在.NET Isolated V4环境中触发报错：

Microsoft.Azure.WebJobs.Host: Error indexing method 'Functions.UpdateCustomerVoucherList'. Microsoft.Azure.WebJobs.Extensions.CosmosDB: Cannot create Collection Information for Vouchers in database Vouchers with lease leases in database Vouchers : Unable to resolve app setting for property 'CosmosDBTriggerAttribute.ConnectionStringSetting'. Make sure the app setting exists and has a valid value. Microsoft.Azure.WebJobs.Extensions.CosmosDB: Unable to resolve app setting for property 'CosmosDBTriggerAttribute.ConnectionStringSetting'. Make sure the app setting exists and has a valid value.

已在local.settings.json中配置连接字符串，且HTTP触发器可正常使用该配置：

"Values": {
    "ConnectionString": "AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5...."
}

解决步骤 #

• 确认使用正确的NuGet包
  进程内模式依赖Microsoft.Azure.WebJobs.Extensions.CosmosDB，而Isolated模式必须安装Microsoft.Azure.Functions.Worker.Extensions.CosmosDB（版本建议匹配Function Runtime V4），卸载旧包并安装对应扩展包。

• 在Program.cs中注册CosmosDB扩展服务
  Isolated模式为独立进程架构，需显式注册扩展服务，在Program.cs中添加配置：

  var host = new HostBuilder()
      .ConfigureFunctionsWorkerDefaults()
      .ConfigureServices(services =>
      {
          services.AddCosmosDB();
      })
      .Build();
  
  host.Run();
  

• 检查触发器属性的命名空间
  确保代码引用Isolated模式专属的触发器命名空间：

  using Microsoft.Azure.Functions.Worker.Extensions.CosmosDB;
  

  替换进程内模式的using Microsoft.Azure.WebJobs.Extensions.CosmosDB;

• 验证local.settings.json结构
  确认连接字符串配置在Values节点下（Azure Functions读取配置的标准节点），示例完整结构：

  {
      "IsEncrypted": false,
      "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
          "ConnectionString": "AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5...."
      }
  }
  

• 确认租赁集合权限
  若租赁集合已存在，确保连接字符串对应的账号拥有该集合的读写权限；若设置CreateLeaseCollectionIfNotExists = true，则账号需具备目标数据库的写入权限以自动创建租赁集合。

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