测试项目Debug文件夹自包含EXE启动报错，如何测试控制台应用？

尝试从xUnit测试项目的Debug文件夹中启动自包含EXE时遇到错误，错误信息如下：

A fatal error was encountered. The library 'hostpolicy.dll' required to execute the application was not found in 'C:\Program Files\dotnet'.
Failed to run as a self-contained app.

• The application was run as a self-contained app because 'C:\Users\me\Desktop\dotnet-testing-cli-issue\MyApp.Console.Tests\bin\Debug\net7.0\MyApp.Console.runtimeconfig.json' did not specify a framework.
• If this should be a framework-dependent app, specify the appropriate framework in 'C:\Users\me\Desktop\dotnet-testing-cli-issue\MyApp.Console.Tests\bin\Debug\net7.0\MyApp.Console.runtimeconfig.json'.

相关项目配置及代码 #

MyApp.Console.csproj #

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  </PropertyGroup>

</Project>

Program.cs #

// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

MyApp.Console.Tests.csproj #

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>

    <IsPackable>false</IsPackable>
    <IsTestProject>true</IsTestProject>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="CliWrap" Version="3.6.0" />
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.3.2" />
    <PackageReference Include="xunit" Version="2.4.2" />
    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.5">
      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
      <PrivateAssets>all</PrivateAssets>
    </PackageReference>
  </ItemGroup>

  <ItemGroup>
    <ProjectReference Include="..\MyApp.Console\MyApp.Console.csproj" />
  </ItemGroup>

</Project>

Tests.cs #

public class UnitTest1
{
    [Fact]
    public async Task Test1Async()
    {
        var result = await Cli.Wrap("MyApp.Console.exe")
            .WithArguments(new[] { "--foo", "bar" })
            .ExecuteAsync();
    }
}

核心需求：这可能是一个X-Y问题，希望测试控制台应用的完整功能（包括通用主机、appsettings等），询问正确的启动和测试方式。

一、修复当前自包含EXE启动错误 #

当前错误的核心原因是：测试项目输出目录中的MyApp.Console.exe并非完整的自包含发布产物。测试项目引用控制台项目时，默认仅复制依赖程序集和基础配置，不会生成包含.NET运行时的完整自包含包。

解决步骤：

1. 单独发布控制台项目为自包含应用：
   进入控制台项目目录，执行命令：

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

2. 在测试代码中指定发布后的完整EXE路径：

   var exePath = Path.Combine(
       Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location),
       "../../../../MyApp.Console/bin/Debug/net7.0/win-x64/publish/MyApp.Console.exe"
   );
   var result = await Cli.Wrap(exePath)
       .WithArguments(new[] { "--foo", "bar" })
       .ExecuteAsync();
   

二、更高效的控制台应用测试方案（推荐） #

对于包含通用主机、appsettings等完整功能的控制台应用，直接调用EXE并非最优解，推荐以下两种方式：

方式1：直接调用程序入口逻辑 #

将控制台应用的核心逻辑抽离或暴露，允许测试项目直接调用：

• 修改Program.cs，暴露主机构建方法：

  public static IHostBuilder CreateHostBuilder(string[] args) =>
      Host.CreateDefaultBuilder(args)
          .ConfigureServices((context, services) =>
          {
              // 配置服务逻辑
          });
  
  public static async Task Main(string[] args)
  {
      var host = CreateHostBuilder(args).Build();
      await host.RunAsync();
  }
  

• 在测试项目中直接调用并测试：

  [Fact]
  public async Task TestHostFunctionality()
  {
      var args = new[] { "--foo", "bar" };
      using var host = MyApp.Console.Program.CreateHostBuilder(args).Build();
      
      // 测试服务逻辑，例如获取服务并验证输出
      var myService = host.Services.GetRequiredService<IMyService>();
      var result = myService.DoSomething();
      
      Assert.Equal("ExpectedResult", result);
  }
  

方式2：使用TestHost测试Web类控制台应用 #

如果控制台应用基于WebHost（如Web API），可使用Microsoft.AspNetCore.TestHost模拟测试：

1. 在测试项目中添加包引用：

   <PackageReference Include="Microsoft.AspNetCore.TestHost" Version="7.0.0" />
   

2. 编写测试代码：

   [Fact]
   public async Task TestWebApiEndpoint()
   {
       var hostBuilder = MyApp.Console.Program.CreateHostBuilder(Array.Empty<string>());
       using var testHost = new TestServer(hostBuilder);
       var client = testHost.CreateClient();
       
       var response = await client.GetAsync("/api/test");
       response.EnsureSuccessStatusCode();
       
       var content = await response.Content.ReadAsStringAsync();
       Assert.Equal("Hello World", content);
   }
   

总结 #

• 若必须测试独立EXE运行，需确保调用的是完整发布的自包含产物，而非测试项目输出目录下的简化文件；
• 多数场景下，直接调用应用核心逻辑或使用TestHost测试更高效，既能覆盖通用主机、配置读取等所有功能点，也便于调试问题。

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