Azure Service Bus触发器Function App如何设置连接字符串

在Visual Studio中可快速创建基于Service Bus主题新消息触发的Function App，示例代码如下：

namespace streamsinfo
{
    public class gameInfoTrigger
    {
        private readonly ILogger<gameInfoTrigger> _logger;

        public gameInfoTrigger(ILogger<gameInfoTrigger> log)
        {
            _logger = log;
        }

        [FunctionName("gameInfoTrigger")]
        public void Run([ServiceBusTrigger("mytopic", "mysubscription", Connection = "streamEndpoint")]string mySbMsg)
        {
            _logger.LogInformation($"C# ServiceBus topic trigger function processed message: {mySbMsg}");

        }
    }
}

首先明确核心规则：
代码中ServiceBusTrigger特性Connection参数指定的streamEndpoint是配置项的键名，运行时会根据这个键名去当前环境的配置存储中查找对应的实际连接字符串，不是直接填写连接字符串的位置，这也是直接硬编码连接字符串到该参数无法生效的根本原因。

下面分两种场景说明具体配置方式：

本地调试运行场景 #

• 配置位置：项目根目录下的local.settings.json文件，该文件仅在本地调试时被函数运行时加载，默认不会随项目发布到云端
• 配置步骤：
  1. 打开local.settings.json，找到Values配置节点
  2. 在节点内新增键值对，键名严格填写streamEndpoint，值为Service Bus命名空间的有效连接字符串（需具备对应主题、订阅的监听/管理权限）
  3. 配置参考示例：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "本地调试所用存储账户连接字符串",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "streamEndpoint": "Endpoint=sb://<你的Service Bus命名空间>.servicebus.windows.net/;SharedAccessKeyName=<访问策略名>;SharedAccessKey=<访问密钥>"
  }
}

• 注意事项：local.settings.json默认被纳入.gitignore规则，不要将该文件提交到公共代码仓库，避免访问密钥泄露。

部署至Azure云环境运行场景 #

云端运行时函数会优先加载应用程序设置中配置的环境变量，不会读取项目内的local.settings.json内容，配置位置为目标Function App的应用程序设置面板，支持两种配置方式：

• 手动配置：
  1. 进入Azure门户中对应Function App的资源页，在左侧菜单栏找到「设置」-「配置」
  2. 在「应用程序设置」标签页选择「新建应用程序设置」，名称填写streamEndpoint，值填写对应Service Bus连接字符串，若需要配置在部署槽位交换时保留该值，可勾选「部署槽位设置」
  3. 点击「保存」，等待Function App重启后配置即可生效
• 发布流程自动配置：
  在Visual Studio中右键项目选择「发布」，进入发布向导的服务依赖绑定环节，选择目标Service Bus实例，发布流程会自动将对应Service Bus的连接字符串注入到云端Function App的应用程序设置中，无需手动复制填写。

配置校验提示：无论本地还是云端场景，配置的键名必须与Connection参数指定的名称拼写一致，否则触发器会因找不到连接字符串启动失败。

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