如何配置Azure Functions BlobTrigger实现单Blob触发仅执行一次

问题根因 #

Blob触发器内部基于存储队列实现调度，但默认不会读取host.json中queues配置节下全局的maxDequeueCount值，其内部用于调度Blob事件的队列，在存储扩展中默认硬编码的最大出队重试次数为5，因此执行失败后会累计触发5次才移入webjobs-blobtrigger-poison毒队列。官方文档中Blob专属配置节仅暴露了并发控制参数maxDegreeOfParallelism，没有直接提供重试次数配置入口，因此直接修改全局队列重试次数不生效。

实现单次执行的配置方法 #

请先确认你的函数应用使用的Azure Storage Blob扩展版本≥5.0.0，旧版本（v3.x及更早）硬编码了重试次数，没有开放配置入口，需要先升级扩展版本再做如下配置：
在host.json中添加针对Blob触发器内部专用队列的单独重试配置，不要修改全局队列的重试配置避免影响其他队列触发器，配置示例如下：

{
  "version": "2.0",
  "extensions": {
    "blobs": {
      // 保留你原有的Blob并发配置
      "maxDegreeOfParallelism": 8
    }
  },
  // 单独为Blob触发器的内部调度队列配置最大出队次数为1，失败直接进毒队列不重试
  "extensions.queues.customQueues.webjobs-blobtrigger.maxDequeueCount": 1
}

验证方式 #

配置完成后重启函数应用，在Blob触发函数中主动抛出异常模拟执行失败，查看日志：不会再出现4次重复触发记录，会直接输出消息移入毒队列的日志，即实现了每次Blob事件仅触发执行一次的效果。

注意事项 #

• 禁止直接将全局extensions.queues.maxDequeueCount设置为1，该配置会作用于函数应用内所有普通队列触发器，导致所有队列触发逻辑都失去默认重试能力，产生非预期副作用。
• 该配置仅控制执行失败后的重试行为，Blob本身的创建/更新事件触发逻辑不受影响，新的Blob事件依旧会正常触发函数。
• 若使用低于5.0.0版本的Blob存储扩展，该配置不生效，必须先升级扩展版本后再部署配置。

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