已安装.NET5运行时仍提示找不到Microsoft.NETCore.App 5版本问题

核心原因 #

该问题是以下三类常见配置/环境问题导致的：

• 程序的运行时配置文件版本规则异常：错误提示要求匹配版本号为单数字的5，而非标准三段式的5.0.x版本，运行时无法将单数字版本号映射到已安装的5.0.0/5.0.7运行时分支。
• 系统内dotnet架构不匹配：当前默认调用的dotnet运行时架构（x86/x64）和程序编译的目标架构不一致，不同架构的运行时互相独立不可复用。
• 独立部署程序文件损坏：如果程序采用独立部署模式发布，可能存在发布包缺失运行时组件的问题。

解决步骤 #

1. 检查并修复运行时配置
   找到和Mydll.dll同目录的Mydll.runtimeconfig.json文件，确认运行时配置规则：

{
  "runtimeOptions": {
    "tfm": "net5.0",
    "framework": {
      "name": "Microsoft.NETCore.App",
      "version": "5.0.0"
    },
    "rollForward": "minor"
  }
}

如果version字段的值为单数字"5"，修改为"5.0.0"，同时新增rollForward字段设为minor，允许运行时自动匹配已安装的更高补丁/次版本的5.0分支运行时。

2. 排查dotnet架构匹配问题
   在Windows终端执行where dotnet查看所有dotnet可执行文件的路径：

• 如果C:\Program Files (x86)\dotnet\路径排在C:\Program Files\dotnet\之前，说明系统默认调用的是x86版本的dotnet
• 执行C:\Program Files (x86)\dotnet\dotnet.exe --list-runtimes确认x86环境是否安装了.NET 5运行时
• 若缺少对应架构的运行时，可安装对应架构的.NET 5运行时，或者调整系统PATH变量顺序，把对应架构的dotnet路径移到最前面，也可以直接用完整路径调用dotnet运行程序：

  "C:\Program Files\dotnet\dotnet.exe" Mydll.dll
  

3. 修复独立部署包
   如果程序采用独立部署模式发布，重新发布程序时选择「框架依赖模式」，或者重新生成对应运行时的独立部署包即可。

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