.NET 4.8 WebForms应用启动报错：找不到AspNetCoreModule模块

以下是针对你的情况的具体排查和解决步骤：

• 检查IIS Express应用程序池配置
  右键项目 → 属性 → Web → 服务器选择IIS Express → 点击“应用程序池”右侧的“...”按钮，确认：

  • 托管管道模式为经典（WebForms依赖经典模式，AspNetCoreModule是为.NET Core的集成模式设计的）
  • .NET CLR版本选择v4.0.30319（对应.NET 4.8）
    确认后点击“确定”，重新创建虚拟目录。

• 清理web.config中的.NET Core相关配置
  打开项目根目录的web.config，查找以下内容并删除：

  • <system.webServer>节点下包含AspNetCoreModule或AspNetCoreModuleV2的<modules>或<handlers>条目
  • 整个<aspNetCore>配置节点（如果存在）
    保存后重新启动项目。

• 清理项目缓存和启动配置

  • 删除项目根目录下的.vs隐藏文件夹（该目录存储Visual Studio的缓存配置）
  • 在Visual Studio中右键解决方案 → 清理解决方案，然后重新生成整个解决方案
  • 检查项目的launchSettings.json文件（如果存在），确保没有配置.NET Core相关的启动参数，比如applicationUrl或environmentVariables中的Core相关变量，如有则删除对应条目。

• 检查项目文件(.csproj)的异常配置
  用文本编辑器打开项目的.csproj文件，查找是否存在以下内容：

  • 错误的<TargetFramework>节点（比如指向netcoreapp系列）
  • 任何.NET Core相关的<Import>或<PackageReference>
    如有则删除，保存后重新加载项目。

• 针对本地IIS的额外检查（如果不用IIS Express）
  打开IIS管理器，找到对应应用的应用程序池：

  • 确认托管管道模式为经典，.NET CLR版本为v4.0
  • 若服务器全局注册了AspNetCoreModule，可在该应用池的“高级设置”中，设置“启用32位应用程序”与其他正常运行的4.8项目一致，或者暂时禁用该模块的全局加载（注意：会影响你的Blazor项目，操作前备份配置）

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