Azure Functions中CosmosDBTrigger在Visual Studio中无法触发的问题

我之前也碰到过一模一样的情况——Azure门户里的触发器跑得好好的，本地调试就是没反应，给你分享几个排查方向，应该能解决你的问题：

1. 先测试新增数据，而非修改已有数据 #

Cosmos DB触发器依赖更改源（Change Feed），默认情况下，本地触发器会从更改源的最新位置开始监听。如果你之前用门户的触发器已经处理过那些修改记录，本地的触发器就不会再触发旧的事件了。试试往集合里新增一条全新的文档，看本地会不会有日志输出。

2. 检查租约集合（Lease Collection）的状态 #

Cosmos DB触发器需要租约集合来跟踪已经处理过的更改，默认会自动创建名为leases的集合：

• 确认你的Cosmos DB账户里已经存在leases集合（如果没有，本地运行时应该会自动创建，但有时候权限问题可能导致创建失败）
• 可以在触发器属性里显式指定租约集合参数，确保配置正确：

  [CosmosDBTrigger("Database", "Collection", 
      ConnectionStringSetting = "myCosmosDB",
      LeaseCollectionName = "leases",
      CreateLeaseCollectionIfNotExists = true)]
  

3. 验证local.settings.json的细节 #

虽然你说连接字符串是对的，但还是要再确认几点：

• 连接字符串是主连接字符串（包含AccountKey的那个），只读连接字符串可能无法正常访问更改源
• 确保ConnectionStringSetting的名称和local.settings.json里的键完全一致，比如你代码里写的是myCosmosDB，那配置文件里必须有：

  {
    "Values": {
      "myCosmosDB": "你的完整连接字符串"
    }
  }
  

• 检查连接字符串有没有多余的空格或者缺失的字符，复制的时候很容易出现这种小问题

4. 查看本地运行的详细日志 #

本地调试时，仔细看控制台输出的日志：

• 有没有显示触发器初始化成功的信息？比如Initializing CosmosDB trigger...
• 有没有关于租约集合的警告？比如无法访问租约集合的提示
• 如果input为空，在代码里加个判断，输出日志确认：

  if (input == null || input.Count == 0)
  {
      log.Info("No new documents detected in change feed.");
      return;
  }
  

5. 更新VS的Azure Functions工具 #

你用的VS2017 15.5.4版本不算太新，对应的Azure Functions工具可能存在兼容性问题。打开VS的扩展和更新，找到Azure Functions和Web Jobs工具，更新到最新版本，然后重启VS再试。

6. 检查Cosmos DB的防火墙设置 #

如果你的Cosmos DB配置了IP防火墙规则，要确保本地机器的IP地址被添加到允许列表里。虽然你说写错连接字符串会报错，但如果防火墙拒绝访问更改源，也可能导致触发器无响应。

先从新增数据测试开始，这是最常见的坑，很多人都是因为测试的是已经被处理过的更改记录，所以没反应。如果还是不行，再一步步排查上面的其他点。

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