Azure队列触发器单实例并发异常：Batch Size=1仍并行处理多消息

数据老陈

2026-7-30

单实例强制仅处理一条Azure队列触发消息的配置问题

问题场景

在消耗计划的Azure Function App中，部署了Python编写的httpTrigger与queueTrigger：httpTrigger生成消息供queueTrigger处理，消息处理时长短则1分钟内，长则约5分钟。

当前host.json已配置以下属性：

batchSize: 1
newBatchThreshold: 0
dynamicConcurrencyEnabled: false

但发送8个请求后，单实例仍同时处理所有消息（已通过日志与Analytics Insights确认），需找出遗漏配置以强制单实例一次仅处理一条消息。

关键遗漏配置

你缺少队列扩展中的**maxConcurrentCalls**配置项，该属性控制单实例上同时处理的队列触发函数调用数量，默认值为16，这是单实例同时处理多条消息的核心原因。

需在host.json的extensions.queues节点中添加该配置：

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    }
  },
  "extensions": {
    "queues": {
      "maxDequeueCount": 1,
      "batchSize": 1,
      "newBatchThreshold": 0,
      "maxConcurrentCalls": 1  // 新增此配置项
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[3.3.0, 4.0.0)"
  },
  "concurrency": {
    "dynamicConcurrencyEnabled": false,
    "snapshotPersistenceEnabled": false
  },
  "functionTimeout": "00:10:00"
}