IIS 10父级环境变量无法传递至子目录站点的原因排查

问题背景 #

在IIS 10的默认站点company_tld下托管多环境ASP.NET Core应用，常规应用可通过站点根目录web.config的environmentVariables节点设置ASPNETCORE_ENVIRONMENT并正常继承，但服务器场部署的\company_tld\app-farm\server[one|two]应用仅能在自身目录的web.config中设置该变量，上层配置无法传递至应用进程。

可能原因 #

1. ASP.NET Core模块继承配置未明确生效
   上层web.config的aspNetCore节点虽默认开启继承，但服务器场的特殊配置可能修改了继承规则，导致子应用无法获取上层环境变量。
2. 服务器场配置的隐性隔离
   服务器场在applicationHost.config中的配置可能存在独立的环境变量或应用池设置，直接覆盖了站点层级的ASPNETCORE_ENVIRONMENT变量。
3. 深层应用web.config的空环境变量块覆盖
   若深层应用的web.config中存在空的<environmentVariables>节点，即使未设置任何变量，也会覆盖上层继承的环境变量配置。
4. 应用池环境变量冲突
   服务器场应用使用的应用池若单独配置了ASPNETCORE_ENVIRONMENT变量，会优先于站点层级的配置生效。

排查与解决步骤 #

1. 确认上层web.config的aspNetCore节点配置 #

打开\company_tld\web.config，确保aspNetCore节点明确开启继承，且环境变量配置正确：

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

重点检查inheritInChildApplications="true"是否存在，该属性直接控制子应用对当前节点配置的继承权限。

2. 检查applicationHost.config中的服务器场配置 #

打开%windir%\System32\inetsrv\config\applicationHost.config，定位到对应服务器场的<serverFarm>节点，检查是否存在<environmentVariables>或<applicationPools>的独立配置。若服务器场设置了自身的ASPNETCORE_ENVIRONMENT变量，需删除或调整为与站点层级一致。

3. 清理深层应用web.config的空环境变量块 #

若\company_tld\app-farm\server\one\web.config中存在空的<environmentVariables>节点，需删除该块，或显式开启继承：

<aspNetCore processPath="dotnet" arguments=".\ServerOneApp.dll">
  <!-- 空块会覆盖上层变量，建议删除或添加继承属性 -->
  <environmentVariables inheritInChildApplications="true">
  </environmentVariables>
</aspNetCore>

4. 验证应用池的环境变量配置 #

通过IIS管理器进入应用池的“高级设置”，查看“环境变量”项，确认是否存在ASPNETCORE_ENVIRONMENT的独立设置。若有，需删除该配置，确保应用池继承站点层级的变量。

5. 用Process Monitor验证变量传递 #

使用Process Monitor工具跟踪dotnet.exe进程的启动过程，查看进程加载的环境变量是否包含目标ASPNETCORE_ENVIRONMENT值。若未加载，说明配置未被正确读取，需重新检查层级配置的继承规则。

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