Azure Function App .NET 8版本ServiceBusTrigger无法映射Key Vault连接字符串

核心问题 #

Azure Function的ServiceBusTrigger默认只识别连接字符串类型的应用配置项，但从Key Vault加载的配置默认是普通字符串类型，导致触发器无法正确映射。

解决方法 #

方法1：将Key Vault引用配置标记为连接字符串类型

在Function App的配置页面操作：

• 添加/编辑应用设置，名称设为触发器预期的连接字符串键名（比如ServiceBusConnection）
• 值填写Key Vault密钥引用：@Microsoft.KeyVault(SecretUri=你的密钥完整URI)
• 「类型」下拉选择Service Bus（对应你的服务类型）
• 保存后重启Function App，触发器就能正常识别该配置

方法2：在触发器属性中直接指定Key Vault加载的配置键

修改函数的触发器属性，显式指定你从Key Vault加载后能通过config["somekey"]访问的键名：

[FunctionName("YourFunctionName")]
public static void Run(
    [ServiceBusTrigger("your-queue-name", Connection = "somekey")] string queueItem,
    ILogger log,
    IConfiguration config)
{
    // 可在此验证config["somekey"]的值是否正确
    log.LogInformation($"Processed message: {queueItem}");
}

这样触发器会直接读取somekey对应的配置值，无需依赖连接字符串类型标记。

必做验证

• 确认Function App已被授予Key Vault的Get密钥权限（通过系统/用户分配身份配置）
• 检查Key Vault中的连接字符串值与之前JSON文件中的完全一致
• 重启Function App后查看日志，确认无连接字符串加载失败的报错

内容的提问来源于stack exchange，提问作者Meeran S