Node.js环境下Azure Function安装Service Bus扩展失败，求解决方案

问题描述 #

在Node.js环境的Azure Function中配置Service Bus队列触发器参数时，尝试通过func cli执行以下命令安装v5.0.1版本的Service Bus扩展：

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

出现NU1100错误，无法解析.NETCoreApp 3.1相关依赖，且提示扩展包与项目框架不兼容。

核心原因 #

Service Bus扩展v5.x系列要求依赖**.NET 6+运行时**，但当前项目使用的是.NET Core 3.1，同时host.json中已配置Extension Bundle v3.x（对应Azure Functions Runtime v4，基于.NET 6），手动安装扩展时出现版本冲突。

解决方案 #

方案1：使用Extension Bundle自动管理扩展（推荐） #

你的host.json已配置Extension Bundle v3.x，该Bundle默认包含兼容版本的Service Bus扩展，无需手动安装：

1. 删除项目根目录下的extensions.csproj文件（若存在）
2. 重启Azure Function本地服务，Extension Bundle会自动下载并加载所需的Service Bus扩展
3. 原host.json中的Service Bus配置参数无需修改，可直接生效

方案2：手动安装兼容的扩展版本 #

若需手动安装，选择与.NET Core 3.1兼容的Service Bus扩展v4.x系列（如4.7.1），执行命令：

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

注意：v4.x版本的扩展配置项与v5.x基本一致，个别参数差异可参考对应版本官方文档调整

方案3：升级项目至.NET 6以使用v5.x扩展 #

若要使用最新的v5.x扩展，需升级Azure Functions Runtime至v4（基于.NET 6）：

1. 检查local.settings.json中FUNCTIONS_EXTENSION_VERSION配置为~4
2. 确保func cli版本为v4，执行func --version查看，低于v4则更新cli
3. 删除extensions.csproj文件后，重新启动项目，此时可正常安装v5.x扩展或继续使用Extension Bundle v3.x

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