Visual Studio中IIS Express运行ASP.NET Core报500.30启动失败

运行环境 #

• .NET Core 5.0.409
• Visual Studio Professional 2019
• Windows 10

故障表现 #

• 命令行执行dotnet run {project}.csproj时项目可正常运行
• Visual Studio中通过IIS Express启动时直接触发500.30错误
• 启动过程中Startup、Program类中的断点均无法命中
• 系统事件日志无有效参考信息，仅提示：

Application {name} hit unexpected managed exception, exception code = '0xe0434352'. Please check the stderr logs for more information.

• 始终无法成功启用stdout日志功能
• Visual Studio的输出日志中无有效报错信息
• 同一项目在其他设备的Visual Studio环境中可正常运行

排查解决步骤 #

按优先级从高到低操作，都是同场景下验证过的有效方案：

• 优先清理IIS Express本地损坏缓存
  关闭所有打开的Visual Studio窗口，直接删除项目根目录下的隐藏.vs文件夹，再重新打开项目尝试启动。这个文件夹存储了IIS Express本地站点配置、调试缓存，配置损坏时就会出现宿主启动失败、未加载程序集就抛异常的问题，完全匹配断点不命中、命令行运行正常的特征。
  注意：这种宿主层启动失败的场景，请求还没进入ASP.NET Core运行管线，程序集根本没被CLR加载，所以配置stdout日志也不会生成任何内容，不用在日志配置、Program/Startup代码逻辑上浪费时间。
  如果删除.vs文件夹后还是报错，去控制面板「程序和功能」里找到IIS Express，选择「修复」，修复完成后重启电脑再试。
• 检查ASP.NET Core托管模块安装状态
  命令行能正常运行不代表IIS Express依赖的托管模块完好，去路径C:\Program Files\IIS\Asp.Net Core Module\V2下确认存在aspnetcorev2.dll文件，如果文件缺失、版本不对，重装对应版本的ASP.NET Core 5.0 Hosting Bundle，装完执行iisreset重启IIS服务再试。
• 修正平台位数匹配问题
  右键项目打开「属性」面板，找到「生成」标签查看当前平台目标配置。如果项目设置为x64/Any CPU，去VS的「工具-选项-项目和解决方案-Web项目」设置页，把「对网站和项目使用IIS Express的64位版本」选项勾选上，位数不匹配时IIS Express加载CLR会直接失败，根本不会进入程序逻辑。
• 快速定位问题边界
  临时把项目启动模式从IIS Express改成项目自托管启动，如果自托管模式下断点能正常命中、项目可以正常跑，就能100%确定问题出在IIS Express侧的配置、模块安装上，和项目本身代码无关，不用排查代码逻辑。
• 排查全局环境变量冲突
  如果以上操作都无效，检查系统级环境变量里所有DOTNET_*开头的配置，尤其是DOTNET_ROOT、ASPNETCORE_ENVIRONMENT这类变量有没有被设置为异常值。IIS Express启动时默认加载系统全局环境变量，和命令行加载的用户级环境变量不一致时，也会出现启动失败的问题。

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