.NET 5运行时能否运行.NET 3.1应用？如何让.NET Core 3.1程序适配.NET 5环境

核心原理 #

默认.NET Core框架会严格匹配程序编译时指定的运行时版本，你可以通过配置运行时前滚规则，允许程序在更高版本的兼容运行时上启动。

方法1：修改项目文件（永久生效，推荐） #

直接在源码项目中配置规则，后续编译发布都会自动携带配置：

• 右键你的.NET Core 3.1项目，选择「编辑项目文件」，在顶层<PropertyGroup>节点下添加两行配置：

<RuntimeFrameworkVersion>3.1.0</RuntimeFrameworkVersion>
<RollForward>Major</RollForward>

• 参数说明：RollForward设为Major表示允许前滚到更高主版本的运行时，3.1版本的程序就可以自动适配5、6等后续主版本的运行时。如果只想限定适配5.x版本，可以把值改为Minor。
• 配置完成后重新编译打包即可。

方法2：修改已发布程序的配置文件（无需重新编译） #

如果不想修改源码重编译，可以直接改发布产物的配置文件：

• 找到发布目录下和你的exe同名的[程序名].runtimeconfig.json文件，打开编辑，在runtimeOptions节点下添加rollForward配置：

{
  "runtimeOptions": {
    "tfm": "netcoreapp3.1",
    "rollForward": "Major",
    "framework": {
      "name": "Microsoft.NETCore.App",
      "version": "3.1.0"
    }
  }
}

• 修改后将新的配置文件替换到安装包对应的目录即可。

临时测试方法 #

如果要快速验证适配效果，可以在命令行启动程序时临时指定前滚规则：

• 依赖框架发布的程序：dotnet --roll-forward Major 你的程序名.dll
• 直接运行exe的场景：你的程序名.exe --roll-forward Major

注意事项 #

• 配置前请先测试程序在.NET 5运行时下的功能完整性，部分.NET Core 3.1中已标记废弃的API在高版本运行时可能出现行为异常。
• 如果程序引用了第三方NuGet包，需要确认对应包版本是否兼容.NET 5运行时，避免出现依赖加载失败问题。

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