Azure Function v3 CosmosDBTrigger触发延迟高、不可靠问题排查

首先直接回答你的两个核心问题：

1. 函数调用记录不需要数小时展示，正常情况下触发后5-10分钟内就会在监控页面显示，你看到无调用记录代表触发器确实没有运行。
2. Cosmos DB触发器本身不存在可靠性问题，你遇到的延迟、不触发问题基本来自配置错误或运行环境异常。

常见问题排查点 #

配置缺失/错误 #

你当前的触发器配置缺少关键参数，且存在权限隐患：

• 触发器配置未显式指定leaseCollectionName，默认会尝试读取名为leases的集合，请确认该集合存在、且你配置的DB_CONNECTION_STRING有该集合的读写权限
• 输入触发器和输出绑定使用了两个不同的连接字符串（DB_CONNECTION_STRING和_DB_CONNECTION_STRING），请确认前者拥有products集合的读权限、以及租约集合的读写权限，权限不足会导致触发器静默失败，无报错也不触发
• 你配置了maxItemsPerInvocation: 1，如果Cosmos DB中存在大量积压的变更记录，单条处理的效率极低，会出现数小时的延迟

租约集合异常 #

Cosmos DB触发器依赖租约集合记录变更处理进度，租约异常是最常见的不触发原因：

• 确认没有其他Function应用、触发器共用同一个租约集合，多个触发器共用租约集合会出现租约争夺，导致部分分区的变更没有实例处理，出现长期延迟甚至完全不触发
• 检查租约集合中的文档，正常每个Cosmos分区范围对应一个租约文档，如果文档的Owner字段为空，代表没有实例持有该租约，对应分区的变更不会被处理
• 自动创建的租约集合默认使用400RU/s的吞吐量，如果你的触发器实例数多、变更量大，吞吐量不足会导致租约读写失败，触发器无法正常工作

运行逻辑异常 #

• 检查函数代码是否存在未捕获的异常，函数运行失败会导致变更检查点无法更新，触发器会卡在当前位置不再处理后续变更
• 消费计划下如果函数长时间无触发会进入冷启动状态，首次触发可能存在数秒延迟，但不会出现数小时级别的延迟

排查步骤 #

• 进入Function App的日志流页面，实时向Cosmos DB写入数据，查看是否有报错日志输出，日志流是实时采集的，不需要等待聚合
• 查看Application Insights的错误日志，搜索CosmosDBTrigger相关的条目，确认是否存在连接失败、权限不足、租约获取失败的报错
• 临时将maxItemsPerInvocation调整为100，观察处理延迟是否有明显改善
• 为当前触发器单独创建专属的租约集合，避免和其他应用共用，在触发器配置中显式指定leaseCollectionName为新的集合名

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