Azure Function（Cosmos DB触发器）本地401未授权及云端不触发问题排查

一、解决401未授权错误 #

• 核对本地配置的Cosmos DB连接字符串：确保local.settings.json中的连接字符串是从Azure门户Cosmos DB账户“密钥”页复制的完整字符串，包含正确的AccountEndpoint和AccountKey，无拼写错误。
• 检查本地账户权限：VS Code中登录的Azure账户需拥有目标Cosmos DB账户的Contributor或Cosmos DB Account Contributor权限，避免因权限不足触发401。
• 验证Cosmos DB防火墙规则：若开启IP白名单，需将本地IP加入允许列表；测试环境可临时开启“允许从所有网络访问”来排查是否是IP限制导致。
• 排除连接字符串格式问题：不要自定义拼接连接字符串，直接使用门户提供的标准格式。

二、解决函数未触发问题 #

本地测试触发排查 #

• 确保Azure Functions Core Tools为最新版本：旧版本可能存在兼容性问题，执行func --version检查，必要时更新。
• 验证Trigger配置：检查function.json中databaseName、collectionName与Cosmos DB的实际名称完全匹配（区分大小写）；connectionStringSetting需和local.settings.json中的配置项名称一致。
• 测试变更源：向目标Cosmos DB容器插入新文档，观察本地函数控制台日志，确认是否捕获到变更事件。

云端函数触发排查 #

• 核对云端应用设置：Azure门户中函数的应用设置里，Cosmos DB连接字符串需和本地测试有效的字符串一致，无遗漏或错误。
• 确认函数状态：在Azure门户函数页面，确保函数处于“已启用”状态，未被禁用。
• 查看云端日志：进入“监测”>“日志”面板，排查是否有租约容器权限不足、变更源读取失败等触发相关的错误信息。
• 检查租约容器：若function.json指定了leaseCollectionName，需确保该容器已存在；若设置createLeaseCollectionIfNotExists: true，确认租约容器已被自动创建。

三、代码与配置检查要点 #

init.py 关键检查项 #

• Blob Storage客户端初始化需正确读取环境变量中的连接字符串：

  import os
  from azure.storage.blob import BlobServiceClient
  
  blob_service_client = BlobServiceClient.from_connection_string(os.environ["AzureWebJobsStorage"])
  

• 更新Stats.json时，确认Blob容器名称、Blob路径正确，且当前账户拥有该Blob的写入权限。

function.json 标准配置示例 #

确保Trigger和Blob绑定配置正确：

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "type": "cosmosDBTrigger",
      "name": "documents",
      "direction": "in",
      "connectionStringSetting": "CosmosDBConnection",
      "databaseName": "YourTargetDB",
      "collectionName": "YourTargetContainer",
      "leaseCollectionName": "leases",
      "createLeaseCollectionIfNotExists": true
    },
    {
      "type": "blob",
      "name": "outputBlob",
      "direction": "out",
      "path": "your-storage-container/{rand-guid}.json",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

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