Azure Pipeline发布旧.NET项目时，如何替换Web.config的ConnectionStrings？

旧.NET项目通过Azure DevOps构建与部署流水线部署至两个环境，部分机密存储于Azure Key Vault、其余参数在变量组中，当前appSettings下的配置可正常替换，但Web.config中connectionStrings节点的连接字符串无法完成替换。

Web.config核心片段：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
   <connectionStrings>
        <add name="MyDB"  connectionString="Standard Server=$(Server);Database=$(Database);User ID=$(User);Password=$(Password);Trusted_Connection=False;Encrypt=True;"/>
    </connectionStrings>
  <appSettings>
    <add key="ApiKeyGeoCoding" value="$(ApiKeyGeoCoding)" />
    <add key="ApiKeyTimeZone" value="$(ApiKeyTimeZone)" />
  </appSettings>
</configuration>

部署流水线deployment.yml核心配置：

- task: AzureKeyVault@2
  inputs:
    azureSubscription: ${{ parameters.azureServiceConnection }}
    KeyVaultName: ${{ parameters.keyvaultName }}
    SecretsFilter: "*"
    RunAsPreJob: false
- task: IISWebAppManagementOnMachineGroup@0
  inputs:
    IISDeploymentType: IISWebsite
    ActionIISWebsite: StopWebsite
    StartStopWebsiteName: ${{ parameters.IIS_SiteName }}
- task: IISWebAppDeploymentOnMachineGroup@0
  inputs:
    WebSiteName: ${{ parameters.IIS_SiteName }}
    Package: $(Pipeline.Workspace)/**/${{ parameters.packageName }}
    XmlVariableSubstitution: true

已尝试FileTransform任务但未达预期，需解决连接字符串替换问题。

方案1：启用IIS部署任务的连接字符串替换开关 #

IISWebAppDeploymentOnMachineGroup任务默认不自动处理connectionStrings替换，需手动开启对应配置：
修改deployment.yml中的IIS部署任务，添加ConnectionStrings: true参数：

- task: IISWebAppDeploymentOnMachineGroup@0
  inputs:
    WebSiteName: ${{ parameters.IIS_SiteName }}
    Package: $(Pipeline.Workspace)/**/${{ parameters.packageName }}
    XmlVariableSubstitution: true
    ConnectionStrings: true  # 新增此行，开启连接字符串替换功能

方案2：精准配置FileTransform任务 #

若方案1无效，可通过FileTransform任务明确指定替换规则，在AzureKeyVault任务之后、IIS部署任务之前添加以下配置：

- task: FileTransform@2
  inputs:
    folderPath: '$(Pipeline.Workspace)/**/${{ parameters.packageName }}'
    fileType: 'xml'
    targetFiles: '**/Web.config'
    enableXmlTransform: false
    variableSubstitution: '**/Web.config'
    substituteVariablesInFiles: true
    substitutionRules: |
      connectionStrings/add[@name='MyDB']/@connectionString=Standard Server=$(Server);Database=$(Database);User ID=$(User);Password=$(Password);Trusted_Connection=False;Encrypt=True;
      appSettings/add[@key='ApiKeyGeoCoding']/@value=$(ApiKeyGeoCoding)
      appSettings/add[@key='ApiKeyTimeZone']/@value=$(ApiKeyTimeZone)

注意：确保流水线变量（含KeyVault机密）的名称与Web.config中的占位符完全一致，且变量已被正确加载。

方案3：排查变量加载与作用域问题 #

• 查看AzureKeyVault任务的运行日志，确认Server、Database等机密已成功读取并注入流水线变量；
• 检查变量组的作用域，确保其关联到对应部署阶段/环境，避免变量未传递；
• 验证变量名称大小写：Azure DevOps变量默认大小写敏感，Web.config中的$(Server)需与流水线变量名完全匹配。

方案4：使用Web.config环境变换文件（多环境场景推荐） #

为每个环境创建专属变换文件，在构建阶段完成配置替换：

1. 在项目中添加Web.{环境名}.config（如Web.Production.config）：

<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <connectionStrings>
    <add name="MyDB" 
         connectionString="Standard Server=$(Server);Database=$(Database);User ID=$(User);Password=$(Password);Trusted_Connection=False;Encrypt=True;" 
         xdt:Transform="SetAttributes" xdt:Locator="Match(name)"/>
  </connectionStrings>
</configuration>

2. 在构建流水线的VSBuild任务中启用变换：

- task: VSBuild@1
  inputs:
    solution: '**/*.sln'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:TransformWebConfigEnabled=true /p:EnvironmentName=$(EnvironmentName)'
    platform: '$(BuildPlatform)'
    configuration: '$(BuildConfiguration)'

3. 部署阶段直接发布构建生成的包，变换后的Web.config会自动包含对应环境的连接字符串。

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