本地Azure Service Bus触发器不触发，同队列新模板函数正常

云上老周

2026-8-5

排查本地Azure Service Bus触发器不触发的实用步骤

对比host.json配置差异
原解决方案的host.json可能存在特殊配置干扰触发器运行，重点检查serviceBus节点下的参数，比如prefetchCount、batchOptions、disableAutoComplete等。将其与测试用新方案的host.json逐一比对，比如：
```
{
  "version": "2.0",
  "extensions": {
    "serviceBus": {
      "prefetchCount": 10,
      "batchOptions": {
        "maxMessageCount": 100,
        "operationTimeout": "00:02:00"
      }
    }
  }
}
```
清理本地触发器租赁缓存
本地Functions运行时会在.azurefunctions文件夹存储触发器的租赁数据，旧数据可能导致锁死。操作：
1. 停止本地调试进程
2. 删除项目根目录下的.azurefunctions文件夹
3. 重启调试，让系统重新生成租赁信息

验证触发器注解/装饰器配置
确认三个触发器的队列名称拼写完全正确（注意大小写一致性），同时检查Connection参数是否指向local.settings.json中正确的配置键，比如：

[FunctionName("OrderProcessingTrigger")]
public static void Run(
    [ServiceBusTrigger("order-queue", Connection = "ServiceBus_ConnectionString")] string message,
    ILogger log)
{
    log.LogInformation($"Processed message: {message}");
}

查看本地启动日志细节
启动调试时紧盯控制台输出，寻找Service Bus触发器相关的错误提示，比如Failed to register listener for queue、Permission denied等信息，这类日志直接指向问题根源（比如隐性权限配置差异、连接超时）。
核对Functions Runtime版本
检查原项目和测试项目的Functions Runtime版本是否一致：查看.csproj中Microsoft.NET.Sdk.Functions的包版本，或local.settings.json里的FUNCTIONS_WORKER_RUNTIME_VERSION配置。版本不兼容可能导致触发器无法正常初始化。
检查触发器是否被禁用
查看local.settings.json中是否存在类似AzureWebJobs.OrderProcessingTrigger.Disabled = true的配置，同时排查代码中是否有通过环境变量条件禁用触发器的逻辑。