从netcoreapp3.1升级到net6.0后PublishSingleFile发布报错求助

问题场景 #

将项目从netcoreapp3.1升级到net6.0后，执行以下Cake发布命令：

dotnet cake build/build.cake --target=Publish --Verbosity=Diagnostic --runtimeIdentifier=win-x64

开启PublishSingleFile=true时触发错误，提示找不到C:\FolderHost\obj\Release\net6.0\win-x64\singlefilehost.exe；关闭该选项则发布正常，但业务需要单文件输出。

项目配置和Cake发布代码如下：

项目PropertyGroup配置 #

<PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <OutputType>Exe</OutputType>
    <AssemblyName>xxxxx.xxxx.xxxxxx</AssemblyName>
    <RuntimeIdentifiers>win-x64;linux-x64</RuntimeIdentifiers>
</PropertyGroup>

Cake的PublishArtifact方法 #

void PublishArtifact(string projPath, string runtime, string artfDir)
{
  DotNetCorePublishSettings pub = new DotNetCorePublishSettings()
  {
     Framework = "net6.0",
     Runtime =  runtime,
     PublishSingleFile = true,
     Configuration =  "Release",
     NoBuild = true,
     NoRestore = true,
     OutputDir = artfDir + "/" + runtime
  };

  DotNetCorePublish(projPath, pub);
}

原因分析 #

问题出在NoBuild=true的设置上：.NET 6的单文件发布流程依赖构建阶段生成的singlefilehost.exe（该文件是单文件应用的宿主引导程序），跳过构建后，对应Runtime目录下不会生成这个必要文件，导致GenerateBundle任务失败。

解决方案 #

方案1：移除NoBuild设置，发布前自动执行构建 #

修改Cake的发布逻辑，去掉NoBuild=true，或者在发布前显式执行构建步骤，确保生成singlefilehost.exe：

void PublishArtifact(string projPath, string runtime, string artfDir)
{
    // 先执行对应Runtime的构建
    DotNetCoreBuild(projPath, new DotNetCoreBuildSettings()
    {
        Framework = "net6.0",
        Runtime = runtime,
        Configuration = "Release",
        NoRestore = true // 若已提前执行Restore，可保留该设置
    });

    DotNetCorePublishSettings pub = new DotNetCorePublishSettings()
    {
        Framework = "net6.0",
        Runtime = runtime,
        PublishSingleFile = true,
        Configuration = "Release",
        NoRestore = true,
        OutputDir = artfDir + "/" + runtime
        // 移除NoBuild=true，或显式设置为false
    };

    DotNetCorePublish(projPath, pub);
}

方案2：保留NoBuild，但确保构建阶段已生成对应文件 #

如果必须保留NoBuild=true，需要保证在发布前已经完成了对应Runtime的构建：

• 构建命令必须指定与发布一致的Runtime参数（如-r win-x64），否则obj目录下不会生成对应平台的singlefilehost.exe
• 例如提前执行构建命令：

  dotnet build -c Release -f net6.0 -r win-x64
  

方案3：清理旧缓存 #

升级框架后，旧的obj/bin目录缓存可能导致异常，先删除项目根目录下的obj和bin文件夹，再重新执行构建发布。

验证 #

修改后重新执行原发布命令，即可正常生成单文件格式的exe程序。

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