Azure函数报错：Cosmos DB连接配置'CosmosDB'不存在，如何解决？

错误原因是你的CosmosDB输出绑定未正确配置连接信息，默认会查找名为CosmosDB的应用设置，但该配置不存在，因此触发报错。以下是两种可行的解决方法，任选其一即可：

方法1：使用CosmosDB连接字符串（快速生效） #

1. 更新local.settings.json #

在Values节点中添加CosmosDB的完整连接字符串：

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "python",
    "AzureWebJobsStorage": "",
    "AzureWebJobsSecretStorageType": "files",
    "cosmosDatabase": "",
    "cosmosColl": "",
    "connect__accountEndpoint": "",
    "connect__clientId": "",
    "BlobConnStr": "",
    "CosmosDBConnection": "AccountEndpoint=https://你的Cosmos账户名.documents.azure.com:443/;AccountKey=你的账户密钥;"
  }
}

2. 更新function.json的CosmosDB绑定 #

添加connection属性指定连接字符串的配置项，同时移除无效的connect__accountEndpoint属性：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "name": "myblob",
      "type": "blobTrigger",
      "direction": "in",
      "path": "contracts/{name}",
      "connection": "BlobConnStr"
    },
    {
      "direction": "out",
      "type": "cosmosDB",
      "name": "doc",
      "databaseName": "%cosmosDatabase%",
      "collectionName": "%cosmosColl%",
      "connection": "CosmosDBConnection",
      "createIfNotExists": true
    }
  ]
}

方法2：使用托管标识认证（与你代码中的DefaultAzureCredential匹配） #

如果你想依赖托管标识（本地开发用Azure CLI登录、生产用系统分配/用户分配标识）完成认证，无需连接字符串：

1. 更新function.json的CosmosDB绑定 #

将原有的connect__accountEndpoint改为accountEndpoint，并使用应用设置占位符：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "name": "myblob",
      "type": "blobTrigger",
      "direction": "in",
      "path": "contracts/{name}",
      "connection": "BlobConnStr"
    },
    {
      "direction": "out",
      "type": "cosmosDB",
      "name": "doc",
      "databaseName": "%cosmosDatabase%",
      "collectionName": "%cosmosColl%",
      "accountEndpoint": "%connect__accountEndpoint%",
      "createIfNotExists": true
    }
  ]
}

2. 确保本地认证生效 #

• 本地开发时，通过az login登录拥有CosmosDB写入权限的Azure账户；
• 若使用服务主体，需在local.settings.json的Values中添加AZURE_TENANT_ID、AZURE_CLIENT_SECRET，并确保该服务主体已被授予CosmosDB的写入权限。

额外提示 #

你代码中手动创建了CosmosClient，同时又配置了CosmosDB输出绑定，这两种方式二选一即可：

• 若使用输出绑定，可直接在函数参数中接收doc并赋值文档内容，无需手动创建客户端；
• 若想完全自定义CosmosDB操作逻辑，可移除function.json中的CosmosDB输出绑定，直接用你代码中的客户端完成写入。

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