离线Windows设备上ASP.NET Core 3.1发布版应用无法启动求助

核心原因 #

离线设备无法运行的核心原因是缺少.NET Core 3.1运行时依赖——默认发布的框架依赖模式会要求目标设备提前安装对应运行时，离线设备未满足该条件导致启动失败。

具体解决方案 #

1. 重新发布为自包含部署（推荐） #

自包含部署会把.NET Core 3.1运行时和应用代码打包在一起，无需目标设备提前安装运行时，完美适配离线环境：

• 修改项目文件（.csproj），添加以下配置（根据目标设备架构调整RuntimeIdentifier）：

  <PropertyGroup>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier> <!-- 可选值：win-x86、win-arm64，对应设备架构 -->
    <SelfContained>true</SelfContained>
    <PublishSingleFile>false</PublishSingleFile> <!-- 不需要单文件打包就设为false，需要则设为true -->
  </PropertyGroup>
  

• 执行发布命令：

  dotnet publish -c Release -r win-x64 --self-contained true
  

• 将发布生成的整个文件夹复制到离线Windows设备，直接运行MyWebSite.exe即可。

2. 离线安装.NET Core 3.1运行时（备选） #

如果不想重新发布，可在离线设备手动安装运行时：

• 在联网设备下载对应架构的**.NET Core 3.1 Windows离线运行时安装包**；
• 将安装包复制到离线设备完成安装；
• 再把原发布文件夹复制到离线设备，运行MyWebSite.exe即可。

3. 排查其他启动失败原因 #

若以上操作后仍无法运行，可通过以下方式定位问题：

• 右键MyWebSite.exe选择「以管理员身份运行」，排查权限问题；
• 打开命令提示符，进入发布文件夹，手动执行MyWebSite.exe，查看终端输出的错误信息；
• 确认离线设备Windows版本符合要求：Windows 7及以上需安装特定系统更新，建议使用Windows 10及以上版本。

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