Azure DevOps CI/CD：.NET Web API连接字符串移出源码控制方案咨询

遇到这个问题太常见了——我们既要保护敏感的连接字符串不提交到源码控制，又得让MSBuild打包时不报错。针对你的.NET Framework 4.7.2 Web API场景，这里有几个经过验证的可行方案：

方案1：添加模板文件+自动复制（推荐本地开发友好） #

MSBuild打包时需要找到ConnectionStrings.config才能完成复制步骤，所以我们可以给源码库加一个占位模板文件，让构建过程自动生成所需文件：

• 在项目根目录创建ConnectionStrings.config.template，写入空白或占位的连接字符串内容：

  <connectionStrings>
    <!-- 占位模板，本地开发替换为真实内容 -->
  </connectionStrings>
  

• 将这个模板文件提交到Git（git add ConnectionStrings.config.template），确保它被源码控制跟踪
• 修改.gitignore，确保真实的ConnectionStrings.config被忽略：

  ConnectionStrings.config
  

• 编辑项目的.csproj文件，添加一个MSBuild任务，构建前自动把模板复制为目标文件：

  <Target Name="CopyConnectionStringsTemplate" BeforeTargets="BeforeBuild">
    <Copy SourceFiles="ConnectionStrings.config.template" DestinationFiles="ConnectionStrings.config" SkipUnchangedFiles="true" />
  </Target>
  

这样操作后：

• 本地开发时，你可以把ConnectionStrings.config替换为真实内容，Git不会跟踪这个文件
• Azure DevOps构建时，会自动从模板生成ConnectionStrings.config，打包过程不会报错
• 部署到Azure App Service后，应用设置里的真实连接字符串依然会覆盖文件中的内容

方案2：修改MSBuild配置，跳过缺失文件 #

如果不想加模板文件，也可以直接告诉MSBuild：找不到ConnectionStrings.config时跳过复制操作——毕竟运行时Azure应用设置会覆盖这个文件的内容，打包时有没有它其实不影响：

• 打开项目的.csproj文件，找到包含ConnectionStrings.config的<Content>节点（没有的话就添加），修改为：

  <Content Include="ConnectionStrings.config">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <ExcludeFromBuild Condition="!Exists('ConnectionStrings.config')">true</ExcludeFromBuild>
  </Content>
  

• 或者，如果你用特定的发布配置文件（.pubxml），可以在该文件中添加全局跳过设置：

  <PropertyGroup>
    <SkipMissingFiles>true</SkipMissingFiles>
  </PropertyGroup>
  

这个方案更简洁，但本地开发时需要手动创建ConnectionStrings.config，否则本地构建可能会出现警告（不过不影响功能）。

方案3：Azure DevOps流水线自动生成文件 #

如果想完全摆脱本地的ConnectionStrings.config，可以让Azure DevOps在构建阶段自动生成这个文件：

• 在Azure DevOps中创建变量组，添加你的真实连接字符串变量（比如ConnectionStrings.DefaultConnection），标记为机密变量保护敏感信息
• 在CI流水线的构建阶段，添加一个PowerShell任务，生成ConnectionStrings.config文件：

  $connectionStringContent = @"
  <connectionStrings>
    <add name="DefaultConnection" connectionString="$(ConnectionStrings.DefaultConnection)" providerName="System.Data.SqlClient" />
  </connectionStrings>
  "@
  $connectionStringContent | Out-File -FilePath "$(Build.SourcesDirectory)/ConnectionStrings.config" -Encoding UTF8
  

这样构建过程会自动生成所需文件，本地开发时你可以临时在web.config中添加连接字符串，或者用本地配置文件（记得不要提交到Git）。

额外提示 #

• 确保Azure App Service应用设置里的连接字符串名称和项目中配置的完全一致，这样才能正确覆盖文件内容
• 本地开发时，务必确认.gitignore已经正确排除ConnectionStrings.config，避免误提交敏感信息
• 测试流水线时，可以在构建阶段加一个文件检查步骤，验证ConnectionStrings.config是否生成成功

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