如何解决Azure DevOps经典管道中.NET 8 AppSettings环境替换异常？

核心问题 #

你在.NET 8项目中通过Azure DevOps经典构建管道设置ASPNETCORE_ENVIRONMENT=development，但发布后开发环境站点仍加载appsettings.production.json，核心原因是构建阶段的环境变量无法直接作用于运行时，或部署环节存在配置覆盖。

具体解决步骤 #

1. 确保运行时环境变量正确配置 #

Azure DevOps构建管道的变量仅作用于构建过程，不会被打包到发布包中。需要在运行环境（如Azure App Service、服务器）中设置环境变量：

• 若部署到Azure App Service：进入App Service的「配置」→「应用程序设置」，添加ASPNETCORE_ENVIRONMENT，值设为Development。
• 若部署到本地/自建服务器：在服务器环境变量中设置ASPNETCORE_ENVIRONMENT=Development，或在站点的web.config中添加：

  <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess">
    <environmentVariables>
      <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
    </environmentVariables>
  </aspNetCore>
  

2. 修正Azure DevOps发布管道配置 #

在发布管道的「Azure App Service部署」任务中，找到「应用程序设置」选项，直接添加ASPNETCORE_ENVIRONMENT=Development，该配置会自动同步到目标App Service的应用设置中，确保运行时生效。

3. 验证环境变量与配置加载 #

在Startup.cs或Program.cs中添加日志输出当前环境名称，确认运行时环境是否正确：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    Console.WriteLine($"当前运行环境: {env.EnvironmentName}");
    // 其他配置代码...
}

通过查看应用日志，判断是环境变量未生效，还是配置文件加载逻辑问题。

4. 检查发布包中的配置文件 #

下载发布后的zip包，确认appsettings.development.json存在且未被替换。若文件缺失，需在项目.csproj中确保其被包含：

<ItemGroup>
  <Content Include="appsettings.development.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

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