调试Azure Queue Trigger函数：如何留存并查看入队原始消息？

方法1：临时调整消息可见性超时 #

• 在函数的队列触发配置中，将visibilityTimeout设置为较长时长（比如10分钟）。这样函数获取消息后，消息会被隐藏一段时间，你有充足时间通过Storage Explorer查看原始内容。
• 配置示例（local.settings.json或Azure门户应用设置）：

  {
    "Values": {
      "AzureWebJobsStorage": "...",
      "QueueName": "你的队列名",
      "FUNCTIONS_WORKER_RUNTIME": "dotnet",
      "AzureWebJobsQueueVisibilityTimeout": "00:10:00"
    }
  }
  

• 调试完成后务必改回原配置，避免影响正常业务的消息处理效率。

方法2：在函数内添加消息留存逻辑 #

• 直接在函数入口处，把原始消息写入日志或持久化到Blob/Table存储，无需改动外部配置：
  • 日志记录示例（C#）：

    [FunctionName("QueueTrigger")]
    public static void Run([QueueTrigger("你的队列名")] string myQueueItem, ILogger log)
    {
        // 记录原始消息内容
        log.LogInformation($"原始队列消息: {myQueueItem}");
        // 原有业务逻辑代码...
    }
    

  • Blob持久化示例（C#）：

    [FunctionName("QueueTrigger")]
    public static async Task Run([QueueTrigger("你的队列名")] string myQueueItem, 
                                 [Blob("message-backup/{rand-guid}.txt", FileAccess.Write)] Stream outputBlob,
                                 ILogger log)
    {
        // 将消息写入Blob备份
        await using var writer = new StreamWriter(outputBlob);
        await writer.WriteAsync(myQueueItem);
        // 原有业务逻辑代码...
    }
    

• 调试结束后删除这段留存代码即可，不会留下冗余逻辑。

方法3：开启存储账户诊断日志 #

• 启用队列存储的诊断日志，所有入队、出队操作都会被记录到存储账户的日志Blob中，可从中提取原始消息：
  1. 进入Azure门户对应的存储账户
  2. 找到「诊断设置」，添加新的诊断配置
  3. 勾选「队列」类别，选择要记录的日志类型（比如Write对应入队操作）
  4. 设置日志存储的目标位置（如同一账户下的Blob容器）
• 注意：日志存在一定延迟，且会占用存储容量，调试完成后建议关闭。

方法4：临时暂停函数实例 #

• 如果函数在Azure上运行，将函数应用的缩放模式改为「手动」，实例数设为0。此时函数不会处理队列消息，你可以用Storage Explorer自由查看队列内容。
• 查看完成后恢复原有实例数和缩放模式，确保业务正常运行。

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