如何在独立测试项目中初始化.NET Core Minimal API以进行Pact测试？

你的核心问题在于测试代码使用了针对传统Startup类的WebHost.CreateDefaultBuilder().UseStartup<Startup>()，但你的API是.NET 7的Minimal API架构，没有传统Startup类，两者不匹配导致启动失败。下面提供两种可行的解决方案：

方案1：复用现有ProviderStartup逻辑（快速适配） #

先修改API端的ProviderStartup类，将应用构建和启动逻辑分离，避免直接调用阻塞线程的Run()方法：

public static class ProviderStartup
{
    // 抽离应用构建逻辑，返回WebApplication实例
    public static WebApplication CreateApp()
    {
        var repository = ProductRepository.GetInstance();

        var builder = WebApplication.CreateBuilder();
        var webApp = builder.Build();

        webApp.MapGet("/products", () => repository.GetProducts());
        webApp.MapGet("/product/{id}", (string id) => repository.GetProduct(id));

        // 不要在这里调用webApp.Run()，交给测试控制启动
        return webApp;
    }

    // 保留原有的启动入口，供独立运行使用
    public static void Start()
    {
        var app = CreateApp();
        app.Run();
    }
}

然后在测试项目中，通过非阻塞方式启动API，并管理其生命周期：

private readonly ITestOutputHelper _outputHelper;
private WebApplication _providerApp;
private readonly string _providerUri = "http://localhost:7008";

public ProviderApiTests(ITestOutputHelper output)
{
    _outputHelper = output;
    // 创建API实例
    _providerApp = ProviderStartup.CreateApp();
    // 以非阻塞方式启动API
    _ = _providerApp.RunAsync(_providerUri);
}

// 测试结束后停止并释放API资源
public async Task DisposeAsync()
{
    if (_providerApp != null)
    {
        await _providerApp.StopAsync();
        await _providerApp.DisposeAsync();
    }
}

方案2：使用WebApplicationFactory（推荐，符合.NET测试最佳实践） #

这是.NET官方推荐的测试托管Web应用的方式，自动管理应用生命周期，还能方便替换测试依赖：

1. 准备API项目 #

如果你的API使用了顶级语句（Top-level statements），需要在API项目的.csproj中添加以下配置，让测试项目能引用Program类：

<PropertyGroup>
  <GenerateProgramFile>true</GenerateProgramFile>
</PropertyGroup>

2. 创建自定义WebApplicationFactory #

public class ProductApiFactory : WebApplicationFactory<Program>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 可选：替换测试用的依赖，比如用模拟仓库代替真实仓库
        builder.ConfigureServices(services =>
        {
            services.AddSingleton<ProductRepository>(ProductRepository.GetInstance());
            // 或替换为测试版本：services.AddSingleton<ProductRepository, TestProductRepository>();
        });
    }
}

3. 在测试类中使用Factory #

private readonly ITestOutputHelper _outputHelper;
private readonly ProductApiFactory _apiFactory;
private HttpClient _client;

public ProviderApiTests(ITestOutputHelper output)
{
    _outputHelper = output;
    _apiFactory = new ProductApiFactory();
    // 创建用于调用API的HttpClient，无需手动管理端口和启动
    _client = _apiFactory.CreateClient();
}

// Pact契约验证测试示例
[Fact]
public async Task VerifyProductConsumerPact()
{
    var pactVerifier = new PactVerifier(new PactVerifierConfig
    {
        Outputters = new List<IOutput> { new XUnitOutput(_outputHelper) }
    });

    pactVerifier
        .ServiceProvider("ProductAPI", _client.BaseAddress.ToString())
        .HonoursPactWith("ProductConsumer")
        .PactUri(@"../path/to/your/consumer/pact/file.json")
        .Verify();
}

// 自动释放资源
public async Task DisposeAsync()
{
    _client.Dispose();
    await _apiFactory.DisposeAsync();
}

注意事项 #

• 确保测试项目已安装必要NuGet包：PactNet、PactNet.Xunit、Microsoft.AspNetCore.Mvc.Testing
• 方案2无需手动指定端口，WebApplicationFactory会自动分配可用端口，避免端口冲突问题

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