Azure CosmosDB Trigger（Python）插入新文档后无法触发求助

• 环境配置：
  • 资源组：appRG
  • 依赖服务：Azure Function App、Azure Cosmos DB
  • 技术栈：Python（非V2版本），Function Runtime 2.x
• 核心问题：本地调试时，向test数据库的story集合插入文档，触发器能正常触发并输出日志；但部署到云端Function App后，插入文档无任何触发响应，监控面板无调用记录（已等待5分钟）。
• 已做配置与尝试：
  1. 使用官方生成的基础触发器代码：

     import logging
     import azure.functions as func
     def main(documents: func.DocumentList) -> str:
         if documents:
              logging.info('Document id: %s', documents[0]['id'])
     

  2. 配置function.json（遵循V2触发器规范）：

     {  
        "scriptFile": "__init__.py",
        "bindings": [
        {
           "type": "cosmosDBTrigger",
           "name": "documents",
           "direction": "in",
           "leaseCollectionName": "leases",
           "connectionStringSetting": "app_DOCUMENTDB",
           "databaseName": "test",
           "collectionName": "story",
           "createLeaseCollectionIfNotExists": true
        }
      ]
      }
     

  3. 云端应用设置中的app_DOCUMENTDB连接字符串与本地完全一致（以AccountEndpoint开头）；后续尝试替换为Cosmos DB主连接字符串（mongodb://格式），修改对应配置项后问题仍存在。
  4. 已查阅本地调试、Visual Studio触发器异常等相关场景的解决方案，均未解决部署后的触发问题。

1. 确认连接字符串类型匹配 #

Cosmos DB触发器仅支持SQL API连接字符串（以AccountEndpoint开头），不兼容MongoDB API格式的连接字符串（mongodb://开头）。若你的Cosmos DB是MongoDB API实例：

• 前往Cosmos DB门户的“连接字符串”页面，切换到SQL API标签复制对应连接字符串，更新Function App的应用设置。

2. 检查租赁集合状态 #

触发器依赖leases集合存储租赁信息，需确保：

• 若createLeaseCollectionIfNotExists设为true，Function App身份具备集合创建权限；手动创建的leases集合需配置正确的分区键（默认可设为/id）。
• 登录Cosmos DB门户，确认test数据库下存在leases集合，且集合内有租赁记录生成。

3. 对齐运行时版本 #

确保云端Function App的运行时版本与本地一致：

• 进入Function App→“配置”→“常规设置”，确认运行时版本选择~2。

4. 验证Cosmos DB防火墙规则 #

若Cosmos DB配置了IP防火墙，需允许Function App出站IP访问：

• 从Function App“概述”页面复制所有出站IP地址；
• 在Cosmos DB“防火墙与虚拟网络”设置中添加这些IP，或临时开启“允许从所有网络访问”（测试用，生产环境需严格管控）。

5. 查看实时日志排查错误 #

通过Function App日志流查看初始化或运行时错误：

• 进入Function App→“监控”→“日志流”，排查是否存在连接失败、权限不足等异常信息。

6. 重置租赁集合 #

若租赁集合存在脏数据导致触发器异常，可删除leases集合，让触发器重新创建并初始化租赁信息。

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