Blazor Server问题：无法修改ASPNETCORE_ENVIRONMENT环境变量

我有一个带自定义环境变量的Blazor Server应用，想通过web.config把环境设为DevelopmentLocal，但应用一直处于Development环境。

相关代码片段 #

Program.cs 代码 #

...
Console.WriteLine($"This application is running on the environment: {app.Environment.EnvironmentName}");
// 实际输出: This application is running on the environment: Development
// 预期输出: This application is running on the environment: DevelopmentLocal
...

web.config 代码片段 #

...
      <environmentVariables>
        <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="DevelopmentLocal"/>
      </environmentVariables>
...

解决建议 #

• 确认web.config结构正确性：environmentVariables必须嵌套在<aspNetCore>标签内，完整的正确结构示例：

  <system.webServer>
    <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout">
      <environmentVariables>
        <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="DevelopmentLocal"/>
      </environmentVariables>
    </aspNetCore>
  </system.webServer>
  

• 排查系统/用户级环境变量：如果系统或用户环境中已经设置了ASPNETCORE_ENVIRONMENT=Development，会优先覆盖web.config的配置，需要删除或修改该系统变量。
• 重新发布应用：旧的web.config可能未被替换，重新发布时确保部署的是最新配置文件。
• 检查IIS应用池配置：在IIS管理器中找到对应应用池，右键选择「高级设置」，查看「环境变量」是否存在冲突的ASPNETCORE_ENVIRONMENT设置。
• 了解配置加载优先级：ASP.NET Core环境变量加载优先级为：系统环境变量 > 用户环境变量 > IIS web.config > 其他配置源，确保没有更高优先级的配置覆盖你的设置。

内容的提问来源于stack exchange，提问作者Davide Dunne Sánchez