Azure Service Bus触发器锁续期异常：ServiceBusReceivedMessage为空

可能的原因及修复方案 #

1. 手动续期与自动续期冲突 #

你同时启用了函数运行时的自动锁续期（maxAutoRenewDuration=30分钟）和自定义手动续期逻辑，这会导致锁管理逻辑冲突，触发运行时提前清理消息对象。

修复：
二选一保留一种续期方式：

• 若使用手动续期，需在host.json中禁用自动续期：

  {
    "version": "2.0",
    "extensions": {
      "serviceBus": {
        "messageHandlerOptions": {
          "autoComplete": false,
          "maxAutoRenewDuration": "00:00:00"
        }
      }
    }
  }
  

• 若依赖自动续期，删除自定义的手动续期代码，确保maxAutoRenewDuration大于任务耗时（比如设为00:25:00）。

2. 函数执行超时导致实例回收 #

Azure Functions消费计划默认执行超时为5分钟，即便Service Bus锁续期正常，函数本身会因超时被终止，后续调用CompleteMessageAsync时消息对象已被清理。

修复：

• 在host.json中调整函数超时时间，覆盖20分钟的任务耗时：

  {
    "version": "2.0",
    "functionTimeout": "00:25:00"
  }
  

  注意：消费计划最长支持60分钟超时，若需更长时间需切换到高级或专用计划。

3. 消息对象被意外置空或回收 #

检查XmlProcessor函数代码，确认receivedMessage变量未被意外赋值为null，且在整个执行周期中保持引用，避免被垃圾回收。

修复示例：

private async Task ProcessXmlTask(ServiceBusReceiver receiver, ServiceBusReceivedMessage receivedMessage)
{
    var cancellationTokenSource = new CancellationTokenSource(TimeSpan.FromMinutes(25));
    
    // 启动手动续期任务
    var renewLockTask = Task.Run(async () =>
    {
        while (!cancellationTokenSource.Token.IsCancellationRequested)
        {
            await Task.Delay(TimeSpan.FromMinutes(4), cancellationTokenSource.Token);
            await receiver.RenewMessageLockAsync(receivedMessage, cancellationTokenSource.Token);
        }
    }, cancellationTokenSource.Token);

    // 执行耗时20分钟的XML处理任务
    await RunLongRunningXmlProcessing();

    // 终止续期任务并等待完成
    cancellationTokenSource.Cancel();
    await renewLockTask;

    // 完成消息前先检查对象有效性
    if (receivedMessage != null)
    {
        await receiver.CompleteMessageAsync(receivedMessage);
    }
}

4. 未捕获异常导致函数提前退出 #

若函数执行过程中抛出未捕获的异常，会导致函数上下文提前释放，receivedMessage对象被清空。

修复：

• 为任务逻辑添加全局异常捕获，确保函数正常执行到完成消息的步骤：

  try
  {
      // 执行耗时任务和续期逻辑
  }
  catch (Exception ex)
  {
      // 记录异常，必要时调用AbandonMessageAsync放弃消息
      if (receivedMessage != null)
      {
          await receiver.AbandonMessageAsync(receivedMessage);
      }
      throw;
  }
  

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