Azure App Service部署后无法读取ASPNETCORE_ENVIRONMENT值如何解决

架构老林

2026-10-4

问题排查与解决方案

检查发布内容是否包含launchSettings.json
ASP.NET Core运行时如果检测到发布目录存在Properties/launchSettings.json，会优先读取该文件内的环境变量配置，优先级高于Azure应用服务注入的系统变量。需要在项目的.csproj文件中添加配置，发布时排除该文件：
```
<ItemGroup>
  <Content Remove="Properties\launchSettings.json" />
  <None Include="Properties\launchSettings.json" />
</ItemGroup>
```
检查Azure部署槽配置匹配性
Azure应用服务每个部署槽的应用设置相互独立，首先确认你部署的目标槽（Production/Stage）的Configuration -> Application Settings页面确实添加了对应变量，其次如果你勾选了变量的部署槽设置复选框，该变量只会绑定到当前槽，不会随槽交换同步，需确认访问的实例对应槽的变量值正确。
检查web.config是否存在硬编码配置
如果你项目中自带了web.config文件，或者发布时自动生成的web.config中硬编码了ASPNETCORE_ENVIRONMENT的取值，会覆盖Azure注入的配置。需删除web.config中如下类似配置：
```
<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
```
调整环境变量读取方式
不建议直接用Environment.GetEnvironmentVariable读取环境变量，ASP.NET Core内置的IWebHostEnvironment已经封装了正确的配置源优先级读取逻辑，直接使用该实例获取环境名即可：
```
// 在Program.cs中直接读取
var builder = WebApplication.CreateBuilder(args);
var env = builder.Environment.EnvironmentName;
```
验证变量注入结果
可以直接进入Azure应用服务的Kudu高级工具，在Environment页面查看进程级环境变量的实际值，确认ASPNETCORE_ENVIRONMENT是否被正确注入，快速定位是配置未生效还是代码读取逻辑问题。