将.NET应用发布为单文件后在Win11设备启动报错求助

针对你遇到的问题，给你几个排查和解决方向：

• 确认发布配置的正确性
  自包含单文件发布必须同时指定两个关键参数，检查你发布时的命令或IDE配置：

  • 命令行发布需确保参数完整：dotnet publish -r win-x64 -c Release /p:PublishSingleFile=true /p:SelfContained=true
  • 如果用Visual Studio发布，在发布配置里要勾选“部署模式：独立”和“生成单个文件”，两者缺一不可。若只勾了单个文件但部署模式选了“框架依赖”，本质还是需要依赖机器上的.NET运行时，且可能内嵌资源处理异常。

• 排查文件传输与完整性问题

  • 让朋友直接复制exe文件到本地，避免通过压缩包中转（部分老旧压缩工具会错误拆分单文件exe的内嵌资源）。如果必须用压缩包，建议用Windows自带的Zip压缩/解压功能。
  • 对比你本地exe和朋友机器上exe的MD5哈希值，确认文件在传输过程中没有损坏。

• 检查代码或依赖是否硬编码读取deps.json

  • 排查项目代码中是否存在直接读取NameOfProject.deps.json的逻辑（比如File.ReadAllText("NameOfProject.deps.json")）。单文件发布时，这类文件会被内嵌到exe中，无法通过本地文件路径读取，需改用Assembly.GetExecutingAssembly().GetManifestResourceStream()来访问内嵌资源。
  • 检查第三方NuGet依赖，部分老旧包可能存在硬编码读取deps.json的情况，尝试将依赖更新到最新稳定版本。

• 验证.NET运行时版本一致性

  • 确认朋友机器上安装的.NET运行时版本和你发布时使用的SDK版本完全匹配（比如你用.NET 8.0.1 SDK发布，朋友需安装.NET 8.0.1 Runtime）。即使都是“最新版本”，小版本差异也可能导致兼容问题。

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