.NET Aspire应用部署时如何持久更新SQL连接字符串？

核心原因 #

azd deploy会严格按照本地环境配置（config.json、环境变量）和基础设施模板（Bicep/ARM）重新生成应用配置，直接在Azure门户修改的设置会被覆盖。你看到的GUID标识Vault大概率是.NET Aspire本地开发环境自动创建的临时本地Vault，并非Azure上的资源。

具体解决步骤 #

• 更新azd环境变量
  直接在本地设置新的连接字符串环境变量，确保部署时读取这个值：

  # 替换为你项目实际使用的连接字符串变量名（比如ConnectionStrings__Default或AZURE_SQL_CONNECTION_STRING）
  azd env set 你的连接字符串变量名 "新的数据库连接字符串"
  

• 修正基础设施模板（若存在硬编码或错误引用）
  打开azd项目infra目录下的Bicep/ARM模板文件，检查容器应用的连接字符串配置：

  • 如果模板里硬编码了初始连接字符串，替换为引用环境变量参数：

    // 示例：容器应用的连接字符串配置
    connectionStrings: {
      Default: {
        value: parameters('你的连接字符串参数名')
        type: 'SQLAzure'
      }
    }
    

  • 确保模板中的参数值从azd环境变量获取，而非过时的Vault引用。

• 配置真实的Azure Key Vault（可选，推荐生产环境）

  1. 在Azure门户创建一个Key Vault，将新的连接字符串存入为密钥（比如命名为SqlConnectionString）。
  2. 更新azd环境变量指向这个Vault：

     azd env set KEY_VAULT_NAME "你的Key Vault名称"
     

  3. 修改模板，让容器应用从这个Vault读取密钥：

     connectionStrings: {
       Default: {
         value: '@Microsoft.KeyVault(SecretUri=https://${parameters('keyVaultName')}.vault.azure.net/secrets/SqlConnectionString/)'
         type: 'SQLAzure'
       }
     }
     

• 重新部署
  执行azd deploy（若修改了基础设施模板，先执行azd provision更新资源配置），此时部署会使用你设置的新连接字符串，不会再覆盖为初始值。

内容的提问来源于stack exchange，提问作者Carl Heinrich Hancke