CosmosDBTrigger绑定WebJob异常：WebJob1未触发问题排查

我在3个WebJob中配置了指向同一CosmosDB容器的CosmosDBTrigger，预期容器发生Upsert操作时3个WebJob都会被触发，但目前WebJob1完全无响应，WebJob2和WebJob3可正常触发。即使单独禁用另外两个Job，WebJob1依然没有任何反应，断点也无法命中。三个Job的触发器配置逻辑如下：

WebJob1代码 #

public async Task ProcessMessageAsync(
    [CosmosDBTrigger(
      "%Database:DatabaseName%", 
      "%Database:ContainerName%", 
      Connection = CosmosDbConnectionString, 
      CreateLeaseContainerIfNotExists = true, 
      LeaseContainerName = "leases", 
      LeaseContainerPrefix = nameof(WebJob1)
    )]
      string documents, CancellationToken cancellationToken)
{
  // Logic
}

WebJob2代码 #

public async Task ProcessMessageAsync(
    [CosmosDBTrigger(
      "%Database:DatabaseName%", 
      "%Database:ContainerName%", 
      Connection = CosmosDbConnectionString, 
      CreateLeaseContainerIfNotExists = true, 
      LeaseContainerName = "leases", 
      LeaseContainerPrefix = nameof(WebJob2)
    )]
      string documents, CancellationToken cancellationToken)
{
  // Logic
}

WebJob3代码 #

public async Task ProcessMessageAsync(
    [CosmosDBTrigger(
      "%Database:DatabaseName%", 
      "%Database:ContainerName%", 
      Connection = CosmosDbConnectionString, 
      CreateLeaseContainerIfNotExists = true, 
      LeaseContainerName = "leases", 
      LeaseContainerPrefix = nameof(WebJob3)
    )]
      string documents, CancellationToken cancellationToken)
{
  // Logic
}

可能的原因及排查步骤 #

• 租约容器中WebJob1的条目异常
  CosmosDBTrigger通过租约容器跟踪处理进度，若WebJob1对应的租约文档（前缀为WebJob1）存在损坏、被标记为完成或锁状态异常，会导致触发器无法正常启动。手动删除leases容器中所有前缀为WebJob1的文档，重启WebJob1让其重新生成租约。

• WebJob1的配置参数未正确加载
  检查WebJob1的配置文件（如appsettings.json）或环境变量，确认Database:DatabaseName、Database:ContainerName和CosmosDbConnectionString的实际值是否与WebJob2/3完全一致。若存在拼写错误或值不匹配，会导致触发器连接到错误的资源，无法接收事件。

• 触发器初始化时发生异常
  查看WebJob1的运行日志（Azure门户WebJob面板或本地调试日志），检查是否有权限不足（连接字符串对应的账号无leases容器读写权限）、租约容器创建失败（虽配置CreateLeaseContainerIfNotExists=true但权限不足）等初始化异常。

• WebJob1的代码或宿主配置问题
  检查ProcessMessageAsync方法是否有未处理的异常导致启动失败，或宿主启动逻辑是否遗漏了CosmosDB触发器的服务注册（如未正确调用AddCosmosDB等扩展方法），确保WebJob1的宿主配置与WebJob2/3一致。

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