.NET Core 6.0配置Program.cs读取对应环境appsettings及环境变量排查

一、确保Azure环境变量被Program.cs识别 #

1. 排除launchSettings.json的发布打包问题 #

launchSettings.json仅用于本地开发环境，部署到Azure后不应该生效。如果部署后它的配置仍在起作用，大概率是发布时误将其包含到了输出包中：

• 检查项目的.csproj文件，移除以下类似配置（如果存在）：

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

默认情况下，.NET发布流程不会将launchSettings.json复制到输出目录，无需额外配置。

2. 确认Azure应用设置配置及生效 #

• 登录Azure Portal，进入目标Web应用 → 配置 → 应用设置，确认ASPNETCORE_ENVIRONMENT已设置为test或staging。
• 修改应用设置后，务必点击保存并重启Web应用（应用设置变更需要重启才能生效）。

3. 验证Program.cs的配置加载逻辑 #

.NET 6的WebApplication.CreateBuilder(args)默认已包含环境变量加载逻辑，可显式添加日志输出验证环境值：

var builder = WebApplication.CreateBuilder(args);

// 输出当前环境名称到日志
var logger = builder.Logging.CreateLogger("Program");
logger.LogInformation("Current runtime environment: {EnvName}", builder.Environment.EnvironmentName);

// 输出Application Insights配置验证
logger.LogInformation("AI Instrumentation Key: {Key}", builder.Configuration["ApplicationInsights:InstrumentationKey"]);

// 后续构建逻辑...
var app = builder.Build();
// ...

二、部署后高效调试环境配置 #

无需额外搭建验证网站，可通过以下方式快速排查：

• 实时日志流：在Azure Portal的Web应用 → 日志流，查看程序启动时的日志输出，直接确认当前环境名称及配置值。
• Kudu控制台：访问https://<你的应用名>.scm.azurewebsites.net/，进入Tools → Environment，查看当前生效的所有环境变量，确认ASPNETCORE_ENVIRONMENT的实际值。
• Azure CLI命令：运行以下命令查询应用设置，验证环境变量配置：

az webapp config appsettings list --name <你的应用名> --resource-group <你的资源组名>

• 启动日志查看：在Azure Portal的Web应用 → 诊断和解决问题，搜索“启动日志”，查看应用启动时的详细日志，排查环境加载异常。

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