Windows7运行自包含.NET5.0免安装应用报1023错误解决方法

错误产生原因 #

• 核心原因是发布时使用了默认的Windows 10系列运行时标识（RID，即win10-x64/win10-x86）。该RID编译出的.NET运行时会直接调用Windows 10及以上版本才提供的系统API，Windows 7没有对应API入口，会导致CLR启动初始化阶段直接崩溃，最终抛出1023致命运行时错误。
• .NET 5对Windows 7属于可选兼容支持范畴，不会默认把Win7兼容层逻辑打包进自包含部署包，必须显式指定对应Win7的RID才会启用兼容逻辑。
• 默认自包含部署配置不会静态链接原生C运行库，哪怕选对了RID，默认配置下的程序仍然会依赖目标系统预装的VC运行库，不符合“无预装依赖”的要求。

满足无依赖、便携运行的正确发布配置 #

第一步：修改项目文件配置 #

右键编辑项目的.csproj文件，在主<PropertyGroup>节点下添加如下配置：

<PropertyGroup>
  <TargetFramework>net5.0-windows</TargetFramework>
  <!-- 声明最低支持Windows 7系统 -->
  <SupportedOSPlatformVersion>7.0</SupportedOSPlatformVersion>
  <!-- 静态链接VC++运行库，无需目标机预装C++运行组件 -->
  <StaticCrtLink>true</StaticCrtLink>
  <!-- 启用单文件打包，所有依赖都嵌入单个exe，满足便携要求 -->
  <PublishSingleFile>true</PublishSingleFile>
  <!-- 自动裁剪未使用的运行库组件，减小发布包体积 -->
  <PublishTrimmed>true</PublishTrimmed>
  <!-- 自解压原生依赖库，不需要额外释放临时文件到系统目录 -->
  <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>
  <!-- 调试符号嵌入程序，不需要额外生成pdb文件 -->
  <DebugType>embedded</DebugType>
</PropertyGroup>

第二步：使用正确的RID执行发布 #

发布时必须显式指定Windows 7对应的运行时标识，不能使用默认的win10系列RID：

• 命令行发布64位兼容版本，直接在项目目录执行：
  dotnet publish -c Release -r win7-x64 --self-contained true
• 需要32位版本时，将RID替换为win7-x86即可。

补充说明 #

• 使用win7-x64/win7-x86 RID发布的自包含程序具备向下兼容性，可以直接在Windows 7、8、8.1、10、11全系列Windows系统上运行，不需要针对高版本系统单独发布。
• 发布完成后，publish目录下生成的单个exe文件就是完整的便携程序，直接拷贝到任意目标PC即可双击运行，不需要提前安装任何组件，包括.NET运行时、各版本C++运行库都不需要预装。
• .NET 6及更高版本已经完全移除了Windows 7兼容支持，无法通过配置实现Win7无依赖运行，.NET 5是最后一个支持Win7适配的.NET跨平台版本。

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