本地开发Azure Functions无法解析Key Vault值求助

问题场景 #

使用VS Code + Azure Functions Core Tools v4.0.7030开发PowerShell运行时的Azure Functions，在local.settings.json的Values字段中配置了@Microsoft.KeyVault(SecretUri=xxx)格式的密钥引用，但本地运行时该配置被当作纯字符串读取，未解析为Key Vault中的实际密钥。线上环境运行正常，已尝试az login、安装Azurite、func azure functionapp fetch-app-settings等操作，均无效果。

解决步骤 #

1. 启用本地密钥解析功能 #

在local.settings.json的Values节点中添加以下配置项，触发Core Tools自动解析Key Vault引用：

"AzureWebJobsFeatureFlags": "EnableSecretStore"

2. 确认身份与权限 #

• 执行az account show命令，确认当前Azure CLI登录的订阅与目标Key Vault所在订阅一致
• 确保当前登录用户对目标Key Vault拥有Key Vault Secrets User角色（或包含Get Secret权限的自定义角色），可通过Azure门户的Key Vault「访问控制」页面检查角色分配

3. 验证启动日志 #

启动函数后查看终端输出，若出现Loading secrets from Key Vault类日志，说明密钥解析已触发。若未出现该日志，尝试重启VS Code和Azure Functions Core Tools，确保配置生效。

4. 手动解析备选方案 #

若原生配置仍无法生效，可在PowerShell函数中直接调用Azure模块获取密钥：

# 首次运行需安装Az.KeyVault模块
Install-Module Az.KeyVault -Scope CurrentUser -Force

# 获取密钥明文值
$apiBaseUrl = Get-AzKeyVaultSecret -VaultName "TestVault" -Name "APIBaseUrl" -AsPlainText

差异排查点 #

• 对比同事的local.settings.json，确认是否存在AzureWebJobsFeatureFlags等关键配置的差异
• 执行func --version检查Core Tools版本，必要时更新至最新版：

  npm install -g azure-functions-core-tools@4
  

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