切换为Nuget分发exe后启动报CoreCLR启动事件未触发错误如何解决

问题根因分析 #

错误码0x80008083属于.NET主机启动失败错误，核心原因是运行时无法加载正确的依赖项/运行时配置，和切换到Nuget分发文件的方式直接相关，常见触发场景如下：

• Nuget包丢失了运行时配置文件：手动打包时很容易遗漏the.runtimeconfig.json、the.deps.json这两个必要的宿主配置文件，这两个文件是.NET 5应用启动必须的，用来指定绑定的.NET版本、依赖项加载规则，少了之后exe无法识别自身对应的运行时，就会报找不到CoreCLR的错误。
• Nuget输出的文件权限异常：手动打包时如果源文件是从其他路径复制的，Windows可能会给文件加「来自网络」的ZoneIdentifier阻止标记，exe启动时会被限制加载运行时组件。
• 生成输出目录的文件覆盖冲突：Nuget引入的文件如果和本地残留的旧版同名称文件版本不一致，会出现覆盖异常，比如旧的runtimeconfig.json留在输出目录，和新的exe版本不匹配。
• 目标架构不匹配：如果类库项目的目标平台是x86，而the.exe是x64，或者反过来，也会出现启动时找不到对应架构运行时的错误。

解决步骤 #

1. 检查Nuget包内的文件清单，确认包含the.exe、the.dll、the.runtimeconfig.json、the.deps.json，以及所有依赖的第三方dll，和之前预生成事件拷贝的文件逐一比对，不要漏了两个json配置文件。
2. 调整Nuget包的打包配置，确保所有文件的「复制到输出目录」属性正确，手动打Nuget的时候需要在nuspec文件里给每个要输出的文件加上copyToOutput="true"的配置，示例配置如下：

<files>
  <file src="the.exe" target="contentFiles\any\any\" copyToOutput="true" />
  <file src="the.dll" target="contentFiles\any\any\" copyToOutput="true" />
  <file src="the.runtimeconfig.json" target="contentFiles\any\any\" copyToOutput="true" />
  <file src="the.deps.json" target="contentFiles\any\any\" copyToOutput="true" />
</files>

3. 清理项目缓存：关闭VS，删除解决方案下的.vs文件夹，删除每个项目的bin、obj文件夹，重新生成项目，避免旧文件残留导致冲突。
4. 检查输出目录下的exe文件属性，看「常规」标签底部有没有「解除锁定」的选项，如果有就勾选后应用，再启动调试。
5. 验证调试配置的目标架构：打开类库项目属性的「调试」页，确认目标平台和the.exe的编译架构一致，都是x64或者都是x86，不要设置为Any CPU。

容易遗漏的配置项 #

• Nuget包的contentFiles配置需要适配PackageReference引用方式，如果只把文件放到Nuget的content目录，用PackageReference引用的项目是不会自动把文件输出到构建目录的，必须放到contentFiles目录并且设置copyToOutput属性。
• 如果the.exe是自包含部署的，还要确保所有运行时相关的dll都被打进Nuget包，不要漏了运行时文件夹里的组件。
• 确认类库项目的目标框架是.NET 5，不是.NET Standard或者其他版本，避免运行时版本不兼容。

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