ASP.NET Core Web API发布到Azure始终处于Production环境问题

安全阿岳

2026-8-29

问题产生原因

核心原因是混淆了编译配置和运行时环境标识两个完全独立的概念：你发布时选择的Debug/Release是编译阶段的配置，只影响编译时的优化策略、调试符号生成逻辑，完全不决定应用运行时的环境判定结果。ASP.NET Core加载哪个环境的appsettings文件，只由运行时读取到的ASPNETCORE_ENVIRONMENT环境变量决定。
Azure Web App服务默认会给所有部署的.NET应用预置ASPNETCORE_ENVIRONMENT环境变量，默认值为Production，本地开发时读取的Development环境值来自项目下的Properties/launchSettings.json，这个文件仅在本地调试时生效，不会随应用发布到Azure，因此不会覆盖Azure上的默认环境变量值。
少数情况是项目文件配置错误，导致appsettings.Development.json根本没有被打包到发布产物中，就算环境变量配对了也找不到对应配置文件。

解决方法

第一步：修改Azure Web App的运行时环境变量
进入对应Web App的Azure管理面板，找到「配置」-「应用程序设置」板块，新增一条应用设置：
- 名称：ASPNETCORE_ENVIRONMENT
- 值：Development
  按需勾选「部署槽设置」选项后保存配置，等待应用自动重启即可完成环境切换。
  如果习惯用命令行操作，也可以在本地安装Azure CLI后执行以下命令完成配置：
```
az webapp config appsettings set --name <你的Web App名称> --resource-group <对应资源组名称> --settings ASPNETCORE_ENVIRONMENT=Development
```
第二步：确认配置文件被正确发布
打开项目的.csproj文件，检查appsettings.Development.json的复制规则，确保没有被设置为不复制到输出目录，正确配置参考如下：
```
<ItemGroup>
  <None Update="appsettings.Development.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>
```
修改后重新发布应用即可。
补充说明：不要依赖发布时的Debug/Release选项控制运行环境，二者没有绑定关系：Release编译模式下只要ASPNETCORE_ENVIRONMENT设为Development，一样会加载Development环境的配置；Debug编译模式下如果环境变量是Production，也只会加载Production环境配置。
环境配置完成后，可以临时加一个测试接口返回Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")的值，确认环境切换生效，避免被发布界面的选项误导。

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