如何为可附加Visual Studio调试器的控制台应用编写集成测试？

方法1：直接在测试中托管Host（无需独立进程，调试最便捷） #

无需启动新进程，直接在测试代码中构建并控制Host生命周期，和ASP.NET Core的WebApplicationFactory思路一致，断点可直接命中控制台应用代码。

修改测试类代码：

internal class IntegrationTests
{
    [Fact]
    public async Task TestHostedServiceLogic()
    {
        // 构建Host，与控制台应用配置保持一致
        var host = Host.CreateDefaultBuilder()
            .UseConsoleLifetime()
            .ConfigureServices((_, services) => services.AddHostedService<CustomHostedService>())
            .Build();

        // 手动启动Host（不会阻塞到RunAsync）
        await host.StartAsync();

        // 此处添加断言逻辑，比如验证服务执行结果、状态等

        // 停止Host
        await host.StopAsync();
        await host.WaitForShutdownAsync();
    }
}

调试测试时，直接在CustomHostedService的StartAsync方法设断点即可命中，完全无需处理跨进程调试问题。

方法2：独立进程模式下添加调试等待逻辑 #

若必须模拟真实控制台启动场景，需在控制台应用中添加等待调试器附加的逻辑，避免进程提前终止。

步骤1：修改控制台应用Main方法 #

internal class Program
{
    static async Task Main(string[] args)
    {
        // 通过命令行参数判断是否为测试模式
        if (args.Contains("--test-mode"))
        {
            // 等待调试器附加
            while (!System.Diagnostics.Debugger.IsAttached)
            {
                System.Threading.Thread.Sleep(100);
            }
        }

        var host = Host.CreateDefaultBuilder(args)
            .UseConsoleLifetime()
            .ConfigureServices((_, services) => services.AddHostedService<CustomHostedService>())
            .Build();

        await host.RunAsync();
    }
}

步骤2：修改测试代码，传递测试参数并等待进程 #

internal class IntegrationTests
{
    [Fact]
    public void TestWithIndependentProcess()
    {
        var process = Process.Start("{assemblyName}.exe", "--test-mode {arguments}");
        
        // 等待进程启动并完成逻辑（根据实际情况调整等待时长）
        process.WaitForExit(5000);

        // 断言逻辑，比如检查进程输出、日志等
        // var output = process.StandardOutput.ReadToEnd();
        // Assert.Contains("预期内容", output);
    }
}

调试时，启动测试后控制台进程会进入等待循环，此时在VS中通过「调试」→「附加到进程」找到对应exe，附加完成后代码继续执行，断点即可命中。

额外优化：调整HostedService终止逻辑 #

你的CustomHostedService在StartAsync执行完立刻调用StopApplication()，导致进程快速退出。可通过配置开关让测试模式下不自动终止Host：

internal class CustomHostedService : IHostedService
{
    private readonly IHostApplicationLifetime _hostApplicationLifetime;
    private readonly IConfiguration _configuration;

    public CustomHostedService(IHostApplicationLifetime hostApplicationLifetime, IConfiguration configuration)
    {
        _hostApplicationLifetime = hostApplicationLifetime;
        _configuration = configuration;
    }

    public async Task StartAsync(CancellationToken cancellationToken)
    {
        // 业务代码逻辑

        // 测试模式下不自动停止应用
        if (!_configuration.GetValue<bool>("TestMode"))
        {
            _hostApplicationLifetime.StopApplication();
        }
    }

    public Task StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
}

测试构建Host时添加内存配置：

var host = Host.CreateDefaultBuilder()
    .ConfigureAppConfiguration(config => config.AddInMemoryCollection(new Dictionary<string, string>
    {
        {"TestMode", "true"}
    }))
    .UseConsoleLifetime()
    .ConfigureServices((_, services) => services.AddHostedService<CustomHostedService>())
    .Build();

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