如何调试重复接收消息的C# Azure Functions并解决执行问题

一、302错误排查 #

302是重定向响应，先从API调用代码入手：

• 检查调用的API是否存在路径变更、HTTP转HTTPS等需要重定向的场景。
• 修改HttpClient配置，允许自动跟随重定向：

  var client = new HttpClient(new HttpClientHandler
  {
      AllowAutoRedirect = true,
      MaxAutomaticRedirections = 5 // 限制重定向次数，防止死循环
  });
  

• 如果API要求手动处理重定向（比如需要携带特定请求头），捕获302响应后，提取Location头字段，重新发起请求。
• 区分问题来源：用Postman或curl模拟函数中的请求参数、头信息直接调用API，看是否返回302。如果是，问题在API端；如果不是，检查函数中请求的URL、头是否有误。

二、消息重复接收问题 #

消息重复是因为函数执行失败后，Service Bus默认会将消息重新入队重试：

• 先解决302错误，从根源减少执行失败。
• 配置Service Bus触发器的重试次数，超过次数后消息移入死信队列，避免无限重复：
  在function.json中添加配置：

  {
    "bindings": [
      {
        "name": "mySbMsg",
        "type": "serviceBusTrigger",
        "direction": "in",
        "queueName": "vs",
        "connection": "ServiceBusConnection",
        "maxDeliveryCount": 3
      }
    ]
  }
  

• 确保函数流程执行完成后再结束，避免中途抛出异常，同时保证函数超时时间足够覆盖50-60秒的流程。

三、本地日志不显示问题 #

• 调整host.json的日志级别，确保函数日志能输出：

  {
    "logging": {
      "logLevel": {
        "Function.getDataSB": "Information",
        "default": "Warning"
      }
    }
  }
  

• 代码中必须使用注入的ILogger输出日志，不要用自定义控制台输出：

  public static async Task Run([ServiceBusTrigger("vs")] string message, ILogger log)
  {
      log.LogInformation("Received message: {Message}", message);
      // 其他业务逻辑的日志输出
  }
  

• 本地运行时，用Azure Functions Core Tools启动函数，日志会直接显示在控制台；如果用Visual Studio，切换到“Azure Functions宿主”输出窗口查看日志。

四、修改函数执行超时时间 #

• 在host.json中配置functionTimeout，不同计划有不同上限：
  • 消费计划：最长10分钟（600秒）
  • 专用/弹性计划：最长60分钟（3600秒）
• 配置示例（设置为1分钟，刚好覆盖你的流程耗时）：

  {
    "functionTimeout": "00:01:00"
  }
  

五、调试建议 #

• 本地调试时，在API调用处设置断点，查看请求的URL、头、参数，以及302响应的Location头详情。
• 启用Service Bus的死信队列，查看失败消息的内容，确认是否是消息数据问题导致API调用失败。
• 发布到Azure后开启Application Insights，能追踪函数执行全流程、API调用的详细日志，快速定位问题。
• 若流程持续耗时较长，可考虑用Durable Functions拆分步骤，避免单函数超时，同时更易跟踪每个环节的状态。

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