Azure函数Cosmos DB变更流触发器首次运行未读取文档问题咨询

你的认知没有问题：当配置StartFromBeginning = true且租约容器中没有对应当前触发器的有效租约记录时，Azure函数Cosmos DB变更流触发器首次运行会从变更流的起点拉取所有存量历史文档，后续运行则会基于租约容器中存储的续传令牌断点读取新增变更。

• 租约容器已存在遗留租约记录：只要你之前运行过一次该函数，自动创建的租约容器中就会生成对应的租约项，存储了当时的变更流读取点位。后续重新运行时，触发器会优先沿用已有租约的点位，StartFromBeginning配置不会再生效。解决方法：删除租约容器内所有对应该函数的租约文档，或直接删除整个租约容器让触发器重新创建即可。
• 配置参数不匹配：首先检查local.settings.json中CosmosDBConnection对应的连接字符串是否指向正确的Cosmos DB账号，确认databaseName、collectionName的拼写与实际资源完全一致（Cosmos DB资源名称大小写敏感），同时确认源容器内确实存在存量文档。
• 存量数据未纳入变更流范围：如果源容器的数据是通过备份恢复、批量导入工具在特殊配置下写入的，部分场景下存量数据的变更记录不会被变更流捕获。你可以尝试往源容器插入一条新测试文档，若触发器能正常响应新增数据，说明存量数据的变更流记录不可用，可通过批量导出导入的方式处理存量数据，后续再用变更流同步增量。
• 扩展包版本不兼容：你当前使用的是旧版变更流触发器语法（CollectionName参数、接收Document类型参数），如果本地安装的Microsoft.Azure.WebJobs.Extensions.CosmosDB扩展包版本为4.x及以上，该版本已改用ContainerName参数、接收IReadOnlyList<JObject>或Container类型参数，版本不匹配会导致配置不生效，变更流无法拉取。

你当前代码中每次触发都新建DocumentClient实例，该对象初始化开销极高，建议改为单例注入复用，避免出现连接泄漏、性能低下的问题。

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