HTTP触发Azure Function本地调试时重复发送Service Bus消息问题

在Visual Studio中开发HTTP触发类型的Azure Function，实现向Service Bus目标端写入单条消息的逻辑。本地运行调试时，单步跟踪确认发送逻辑仅执行1次，但Service Bus端出现多条重复投递的消息，不符合预期的单条发送效果。

相关实现代码 #

ServiceBusClient client = new ServiceBusClient(servicebusconn);
ServiceBusSender sender = client.CreateSender(queuename);
ServiceBusMessage message = new ServiceBusMessage("a");
try
{
    await sender.SendMessageAsync(message);
}
finally
{
    await sender.DisposeAsync();
    await client.DisposeAsync();
}

异常现象参考 #

重复消息的产生通常来自三类单步调试无法感知的执行逻辑：

• SDK内置透明重试触发
  你使用的Azure.Messaging.ServiceBus SDK默认内置了指数退避重试策略，默认最大重试次数为3次。所有重试逻辑完全封装在SendMessageAsync方法内部，外部单步调试只会观测到一次方法调用，无法感知内部执行细节。
  你的代码每次请求都会新建、释放ServiceBusClient，每次发送都要建立全新的AMQP连接，首次连接时出现网络抖动、建连超时、服务端临时限流等瞬时故障的概率远高于复用客户端的场景，极易触发SDK内部重试，每次重试都会实际向Service Bus投递一条消息。
• 本地残留多函数实例
  本地调试时如果之前启动的函数宿主进程（func.exe）没有正常退出，后台会残留多个运行中的函数实例同时监听同一个HTTP端口。你发起的一次HTTP请求会被所有监听实例同时接收处理，如果你只把调试器附加到了其中一个实例，就只会观测到一次发送逻辑执行，其余未附加调试的实例同样会执行发送逻辑，产生重复消息。
• HTTP客户端自动重试
  如果你使用浏览器、Postman等工具发起HTTP调试请求，当函数执行时间过长（比如断点停留时间过久）超过HTTP客户端默认超时时间时，客户端会自动重新发起相同请求。如果你在断点处已经执行完消息发送逻辑，后续重试的请求会再次触发消息发送；如果单步调试时没有跟踪到后续重复的请求入口，就会误以为发送逻辑仅执行了一次。

• 遵循Azure官方最佳实践，不要在每次函数调用时新建和释放ServiceBusClient、ServiceBusSender，改为在函数应用启动时注册单例实例全程复用，降低频繁建连带来的瞬时故障概率。
• 每次启动调试前，先在任务管理器中结束所有残留的func.exe进程，确保仅存在一个运行中的函数实例监听端口。
• 调试阶段可自定义ServiceBusClient配置，临时关闭SDK重试并开启客户端日志，即可直观观测到内部的重试行为，配置示例如下：

var clientOptions = new ServiceBusClientOptions
{
    RetryOptions = new ServiceBusRetryOptions
    {
        MaxRetries = 0, // 调试阶段临时关闭内部重试
        Delay = TimeSpan.FromSeconds(1),
        MaxDelay = TimeSpan.FromSeconds(10),
        Mode = ServiceBusRetryMode.Exponential
    }
};
ServiceBusClient client = new ServiceBusClient(servicebusconn, clientOptions);

• 在函数入口处打印请求唯一标识日志，确认函数实际被触发的次数，排查HTTP客户端自动重试带来的重复调用。

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