Azure Functions（JavaScript）serviceBusTrigger未注册错误求助

这个错误我帮不少开发者排查过，核心问题是Service Bus绑定扩展没有正确配置或安装——你package.json里的azure@2.2.1-preview是旧版的Azure SDK，和Azure Functions的绑定扩展完全不是一回事，反而可能造成冲突。下面是一步步的解决方法：

一、优先使用扩展捆绑（推荐） #

Azure Functions从v3开始推荐用扩展捆绑来管理所有绑定扩展，不用手动安装单个扩展包，步骤如下：

1. 在你的Function项目根目录打开host.json，添加或修改extensionBundle配置：

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[3.*, 4.0.0)"
  }
}

这个配置会自动包含Service Bus、Blob Storage等常用绑定的最新兼容版本。

2. 清理旧依赖并重新安装：
   • 先卸载没用的旧azure包：

     npm uninstall azure
     

   • 删除node_modules文件夹和package-lock.json文件
   • 重新安装依赖：

     npm install
     

二、手动安装Service Bus扩展（如果不用扩展捆绑） #

如果因为某些原因不能用扩展捆绑，可以手动安装对应的WebJobs扩展：

1. 确保你安装了Azure Functions Core Tools（版本v3及以上）
2. 在项目根目录运行以下命令安装Service Bus扩展：

   func extensions install --package Microsoft.Azure.WebJobs.Extensions.ServiceBus --version 5.*
   

3. 同样卸载旧的azure包，安装正确的Azure Functions依赖：

   npm uninstall azure
   npm install @azure/functions
   

三、验证配置文件正确性 #

1. 检查function.json中的触发器配置，确保type是serviceBusTrigger，且connection指向正确的配置项：

{
  "bindings": [
    {
      "name": "sbMessage",
      "type": "serviceBusTrigger",
      "direction": "in",
      "topicName": "你的主题名称",
      "subscriptionName": "你的订阅名称",
      "connection": "ServiceBusConnectionString"
    }
  ]
}

2. 检查local.settings.json，确保包含正确的Service Bus连接字符串和Node运行时配置：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "FUNCTIONS_NODE_RUNTIME_VERSION": "18", // 用Azure Functions支持的版本，比如16/18
    "ServiceBusConnectionString": "Endpoint=sb://你的命名空间.servicebus.windows.net/;SharedAccessKeyName=你的密钥名称;SharedAccessKey=你的密钥值"
  }
}

四、重启本地运行环境 #

完成以上配置后，停止当前的func host start进程，重新运行命令启动：

func host start

一般来说，按这个流程操作就能解决绑定未注册的问题。如果还是有问题，可以检查Azure Functions Core Tools的版本，确保是最新版（可以用func --version查看，然后通过npm或官网更新）。

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