本地IIS Express测试.NET5网站遇HTTP Error 500.0 - ASP.NET Core托管失败

安全阿岳

2026-7-9

解决IIS Express托管.NET5网站时的HTTP Error 500.0错误

检查ASP.NET Core模块启用状态
打开控制面板→程序和功能→启用或关闭Windows功能，确认「Internet Information Services→万维网服务→应用程序开发功能」下的「ASP.NET Core」已勾选，未勾选则勾选后重启电脑。

核对项目launchSettings.json配置
打开项目根目录下的Properties/launchSettings.json，检查IIS Express相关配置：

"iisSettings": {
  "windowsAuthentication": false,
  "anonymousAuthentication": true,
  "iisExpress": {
    "applicationUrl": "http://localhost:xxxx",
    "sslPort": 0
  }
},
"profiles": {
  "IIS Express": {
    "commandName": "IISExpress",
    "launchBrowser": true,
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

确保ASPNETCORE_ENVIRONMENT设为Development，开启详细错误输出便于排查。

获取具体错误信息
查看项目根目录下的Logs文件夹日志，或打开Windows事件查看器，展开「Windows日志→应用程序」，查找来源为ASP.NET Core的错误条目，定位具体异常原因。
修复.NET5运行时
打开命令提示符执行dotnet --list-runtimes，确认Microsoft.AspNetCore.App 5.x运行时已正确安装。若存在异常，重新下载安装.NET5 SDK及运行时，确保系统环境变量Path包含C:\Program Files\dotnet\路径。
清理项目缓存并重建
删除项目根目录的bin、obj文件夹，关闭Visual Studio后删除同级的.vs隐藏文件夹，重新打开项目生成解决方案。