新Windows 2022服务器上.NET 7应用运行失败求助：安装框架仍无效

在新Windows Server 2022服务器上运行.NET 7应用时出现以下异常：

• 已按微软官方指引完成Microsoft.AspNetCore.App 7.0.0（x64）框架安装，安装提示成功
• 执行应用程序时仍报错，提示缺少7.0.0版本，仅检测到8.0.7版本
• 运行命令查看SDK/运行时列表，未显示7.0.0条目；重新安装时系统提示该框架已存在

执行命令及报错信息 #

C:\dimension\auth_service> .\auth_service.exe
You must install or update .NET to run this application.

App: C:\dimension\auth_service\auth_service.exe
Architecture: x64
Framework: 'Microsoft.AspNetCore.App', version '7.0.0' (x64)
.NET location: C:\Program Files\dotnet\

The following frameworks were found:
  8.0.7 at [C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App]

相关截图 #

• 安装成功对话框：
• SDK列表未显示框架但重装提示已存在：

解决思路 #

• 检查安装目录结构：前往C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App，确认是否存在7.0.0文件夹，若不存在则说明安装未真正完成，需清理残留文件后重新安装
• 验证权限：确保服务器运行应用的账户对上述目录有读取权限，权限不足会导致运行时无法检测到框架
• 修复.NET安装：下载对应版本的离线安装包，运行时选择「修复」选项，修复安装中的损坏或未注册问题
• 检查环境变量：确认DOTNET_ROOT环境变量指向C:\Program Files\dotnet\，且该路径已添加到系统PATH中，环境变量错误会导致运行时检测异常
• 强制指定运行时：在应用程序所在目录创建auth_service.runtimeconfig.json文件，明确指定依赖的7.0.0版本，示例内容：

{
  "runtimeOptions": {
    "framework": {
      "name": "Microsoft.AspNetCore.App",
      "version": "7.0.0"
    }
  }
}

• 排查运行时注册：运行dotnet --list-runtimes和dotnet --info获取详细运行时信息，对比输出确认是否存在框架注册异常

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