.NET 6应用因服务器SDK小版本不符启动失败的原因与解决

问题描述 #

我在部署多个.NET应用时遇到了启动失败的问题，报错显示服务器上安装的.NET 6运行时小版本不满足要求。但我的源代码里并没有显式引用任何SDK小版本，项目文件中只配置了<TargetFramework>net6.0</TargetFramework>。

错误详情 #

描述：一个.NET应用运行失败。
Application: app.exe
Path: C:\path\to\app.exe
Message: You must install or update .NET to run this application.

App: C:\path\to\app.exe
Architecture: x64
Framework: 'Microsoft.NETCore.App', version '6.0.15' (x64)
.NET location: C:\Program Files\dotnet\

The following frameworks were found:
  1.0.1 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  1.0.4 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  1.1.1 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  2.0.0 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  2.2.4 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  2.2.6 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  3.1.22 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]
  6.0.8 at [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]

Learn about framework resolution:
https://aka.ms/dotnet/app-launch-failed

To install missing framework, download:
https://aka.ms/dotnet-core-applaunch?framework=Microsoft.NETCore.App&framework_version=6.0.15&arch=x64&rid=win81-x64

问题成因 #

• 编译应用时使用的.NET SDK小版本（比如6.0.15）会自动绑定对应的.NET运行时小版本。即便项目里只声明了net6.0，编译环境的SDK也会把运行时依赖锁定在当前SDK对应的小版本上，这是.NET的默认行为。
• .NET应用启动时默认会严格匹配运行时小版本（除非配置了兼容策略），服务器上只安装了6.0.8版本的运行时，无法满足应用对6.0.15的依赖要求，因此启动失败。

避免部署故障的方法 #

• 显式配置运行时兼容规则：在项目文件中添加<RollForward>LatestMinor</RollForward>，允许应用自动向前兼容到同大版本的最新小版本；或者添加<RuntimeFrameworkVersion>6.0.0</RuntimeFrameworkVersion>，绑定到.NET 6的最低小版本，只要服务器有6.0.x任意版本就能运行。
• 采用自包含部署：编译时使用dotnet publish --self-contained true -c Release命令，把.NET运行时和应用打包在一起，部署时不需要服务器提前安装对应版本的.NET，彻底消除版本依赖问题。
• 统一编译环境的SDK版本：团队内部使用相同小版本的.NET SDK编译项目，或者在项目根目录添加global.json文件固定SDK版本，示例：

  {
    "sdk": {
      "version": "6.0.8"
    }
  }
  

  这样所有应用编译时绑定的运行时版本一致，部署到服务器时只需安装这个统一的小版本即可。
• 部署前检查服务器运行时：在部署脚本中加入dotnet --list-runtimes命令，检查服务器已安装的.NET运行时版本，提前发现版本不匹配的问题，避免部署后故障。

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