.NET 5网站在特定环境下为何需同时安装两个托管包？

问题现象 #

• 仅在特定环境中，.NET 5网站必须同时安装.NET 5和.NET Core 2.1.15托管包才能正常启动
• 移除任意一个托管包（保留对应运行时），网站直接抛出HTTP Error 500.19 - Internal Server Error，且该错误未记录在Windows事件查看器和IIS日志中
• 未安装.NET Core 2.1.15托管包时，在IIS管理器中点击网站并打开「Logging」功能，会弹出错误：

  There was an error while performing this operation. Details: Filename: ?\D:\www\web.config Error:

• 安装.NET Core 2.1.15托管包后，上述IIS Logging操作恢复正常，网站也能正常运行

可能原因 #

1. web.config模块配置依赖：.NET Core托管包会向IIS注册对应模块（如AspNetCoreModuleV2），如果web.config中存在旧版模块配置或交叉依赖项，缺少2.1.15托管包会导致IIS无法正确解析配置，触发500.19错误。
2. IIS子系统隐性依赖：特定环境的IIS配置组件（比如处理Logging的子系统）可能依赖.NET Core 2.1.x托管包中的组件，缺失时无法完成web.config的读取操作。
3. 环境残留配置绑定：该环境曾部署过.NET Core 2.1.x应用，残留的服务器级模块配置或站点绑定规则与当前.NET 5应用冲突，必须保留2.1.15托管包才能维持兼容性。

排查解决步骤 #

1. 检查并清理web.config配置

   • 打开网站根目录的web.config，定位到<system.webServer>下的<handlers>和<aspNetCore>节点，确认只保留.NET 5所需的AspNetCoreModuleV2配置，删除任何指向旧版AspNetCoreModule的冗余配置。示例正确配置：

     <system.webServer>
       <handlers>
         <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
       </handlers>
       <aspNetCore processPath="dotnet" arguments=".\YourApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
     </system.webServer>
     

   • 保存配置后，重启网站尝试移除2.1.15托管包测试。

2. 重新注册.NET 5托管模块

   • 以管理员身份打开命令提示符，执行以下命令重新注册.NET 5的IIS托管模块：

     "%ProgramFiles%\dotnet\dotnet.exe" aspnetcore-module-v2 register
     

   • 执行iisreset重启IIS服务，再测试移除2.1.15托管包后的网站运行情况。

3. 清理IIS服务器残留配置

   • 打开IIS管理器，进入「服务器节点」→「模块」，移除所有与.NET Core 2.1.x相关的未使用模块。
   • 检查网站对应的应用程序池，确认「.NET CLR版本」设置为无托管代码（.NET 5应用无需传统.NET CLR托管）。

4. 验证.NET 5托管包完整性

   • 运行dotnet --info命令，确认输出中包含.NET 5的托管包组件，若缺失则重新下载安装完整的.NET 5托管包。

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