Azure Function本地开发CosmosDBTrigger配置错误求助

环境配置：

• dotnet 版本：6.0.401+
• func 版本：4.0.4736+
• CosmosDB Emulator 版本：azure-cosmosdb-emulator-2.14.7-c041c584
• 系统：Windows 10 Enterprise

启动Azure Function App时触发错误：

The 'blabla' function is in error: Microsoft.Azure.WebJobs.Host: Error indexing method 'Functions.blabla'. Microsoft.Azure.WebJobs.Extensions.CosmosDB: Cannot create Collection Information for blabla_Container in database blabla_Database with lease leases in database blabla_Database : 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.

当前代码配置：

public static async Task Run(
    [CosmosDBTrigger(
    databaseName: "blabla_Database",
    collectionName: "blabla_Container",
    ConnectionStringSetting = "AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==",
    LeaseCollectionName = "leases",
    LeaseCollectionPrefix = "trigger",
    CreateLeaseCollectionIfNotExists = true
    )] string input,
    FunctionContext executionContext
    )

Host.json配置：

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    },
    "logLevel": { "default": "Trace" },
    "fileLoggingMode": "always"
  }
}

Local.settings.json配置：

{
  "AzureWebJobsStorage": "UseDevelopmentStorage=true",
  "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
  "FUNCTIONS_WORKER_RUNTIME_VERSION": "~4"
}

CosmosDB Emulator启动命令：

.\Microsoft.Azure.Cosmos.Emulator.exe /Port=8081 /AllowNetworkAccess [/NoFirewall] /Key=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw==

已验证操作：

• 可正常访问CosmosDB Emulator资源管理器
• 可通过资源管理器创建数据库和容器

1. 修正ConnectionStringSetting配置方式 #

CosmosDBTriggerAttribute.ConnectionStringSetting属性的作用是指向配置文件中的键名，而非直接填写完整连接字符串。当前直接写入连接字符串的方式，导致Function无法识别为有效配置项名称，从而触发错误。

修改Local.settings.json #

添加CosmosDB连接字符串的配置项：

{
  "AzureWebJobsStorage": "UseDevelopmentStorage=true",
  "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
  "FUNCTIONS_WORKER_RUNTIME_VERSION": "~4",
  "CosmosDBConnectionString": "AccountEndpoint=https://localhost:8081/;AccountKey=C2y6yDjf5/R+ob0N8A7Cgv30VRDJIWEHLM+4QDU5DE2nQ9nDuVTqobD4b8mGGyPMbIZnqyMsEcaGQy67XIw/Jw=="
}

修改Function代码 #

将ConnectionStringSetting的值改为配置项的键名CosmosDBConnectionString：

public static async Task Run(
    [CosmosDBTrigger(
    databaseName: "blabla_Database",
    collectionName: "blabla_Container",
    ConnectionStringSetting = "CosmosDBConnectionString",
    LeaseCollectionName = "leases",
    LeaseCollectionPrefix = "trigger",
    CreateLeaseCollectionIfNotExists = true
    )] string input,
    FunctionContext executionContext
    )

2. 确认dotnet-isolated模式扩展包安装 #

由于使用dotnet-isolated运行时，需确保已安装对应的CosmosDB扩展包：

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.CosmosDB --version 4.3.0

（版本号可根据实际需求调整，建议使用与func cli兼容的稳定版本）

3. 重启服务 #

• 关闭当前运行的Function App和CosmosDB Emulator
• 重新启动CosmosDB Emulator（使用提供的启动命令）
• 重新运行Function App

启动Function App后，检查是否仍有错误。配置正确的情况下，CosmosDBTrigger会自动尝试创建leases容器（如果不存在），并开始监听blabla_Container的数据变更。

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