EC2实例IIS部署后.NET Core应用环境变量获取为空问题咨询

首先明确结论：必须在部署的EC2实例环境中完成对应配置，IIS托管的.NET Core应用才能正常读取到该环境变量。

空值出现的根本原因 #

你在本地开发时能正常获取到Development值，本质是本地启动链路（Visual Studio调试、dotnet run命令启动）会自动加载项目目录下Properties/launchSettings.json里定义的环境变量。这套配置仅对本地开发进程生效，且发布应用时launchSettings.json默认不会被打包到部署产物中，完全不会同步到EC2实例的IIS运行时环境。IIS的工作进程默认没有绑定这个变量值，自然会返回空。

两种可靠的配置方案 #

• 实例全局系统变量配置
  直接在EC2实例的系统环境变量面板中，在「系统变量」分组下新建变量，变量名填写ASPNETCORE_ENVIRONMENT，变量值根据你的实际环境填写（如Production、Staging）。配置完成后必须执行iisreset重启IIS服务，或是手动重启对应的应用程序池，让工作进程重新加载环境变量才能生效。
  注意：这种全局配置的变量会被实例上所有部署的.NET应用读取，如果同一台EC2上同时托管多个不同运行环境的应用，会出现配置冲突。
• 单站点定向配置（更推荐，无全局冲突）
  所有.NET Core 2.0及以上版本在IIS上托管时，默认使用ASP.NET Core Module V2承载应用，可以直接通过站点根目录下的web.config文件为当前站点单独配置环境变量，完全不需要修改全局系统设置。配置示例如下：

<aspNetCore processPath="dotnet" arguments=".\你的应用程序.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout">
  <environmentVariables>
    <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
  </environmentVariables>
</aspNetCore>

配置保存后，仅需要重启当前站点对应的应用程序池即可生效，不会影响同实例下其他站点的运行配置。

常见踩坑点 #

配置完环境变量后如果还是读取为空，90%的原因是没有重启对应的IIS应用程序池——IIS工作进程只会在启动阶段加载一次系统/站点级的环境变量，运行中途修改的配置如果不触发进程重启，是不会被加载到内存中的。

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