如何以编程方式启动无Startup类的.NET 6 Minimal API用于PactNet测试

核心思路 #

绕过TestServer或WebApplicationFactory的内存通信限制，直接复用Minimal API的WebApplication构建逻辑，启动绑定真实TCP端口的服务实例，满足PactNet Rust组件的通信要求。

具体实现步骤 #

1. 提供者项目提取可复用的应用构建逻辑

在提供者项目的Program.cs中，将顶级语句重构为部分类，添加静态方法封装应用创建与配置逻辑，方便测试项目调用：

// Program.cs
var builder = WebApplication.CreateBuilder(args);
// 原有的服务配置（如AddSwagger、依赖注入等）
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

// 提取供测试调用的静态方法
public partial class Program
{
    public static WebApplication CreateTestWebApplication(string[] args = null)
    {
        var builder = WebApplication.CreateBuilder(args ?? Array.Empty<string>());
        
        // 复制原项目所有服务注册逻辑
        builder.Services.AddEndpointsApiExplorer();
        builder.Services.AddSwaggerGen();
        // 其他服务配置（数据库、自定义服务等）
        
        var app = builder.Build();
        
        // 复制原项目中间件配置逻辑
        if (app.Environment.IsDevelopment())
        {
            app.UseSwagger();
            app.UseSwaggerUI();
        }
        app.UseHttpsRedirection();
        
        // 复制原项目端点路由逻辑
        app.MapGet("/api/hello", () => "Hello World!")
           .WithName("GetHello")
           .WithOpenApi();
        
        return app;
    }
}

// 原项目启动语句
var app = builder.Build();
// 原中间件、端点配置
// ...
app.Run();

2. 测试项目中编程启动真实服务

在Pact提供者测试类中，通过Setup和Teardown方法完成服务的启动与停止，指定真实端口：

using PactNet;
using PactNet.Verifier;

public class ProviderTests : IDisposable
{
    private WebApplication _testApp;
    private readonly string _providerUri = "http://localhost:5001"; // 指定真实端口

    [OneTimeSetUp]
    public void Setup()
    {
        // 启动测试服务，绑定指定端口
        _testApp = Program.CreateTestWebApplication(new[] { $"--urls={_providerUri}" });
        _testApp.StartAsync().Wait(); // 等待服务完全启动
    }

    [Test]
    public void VerifyPact()
    {
        var pactVerifier = new PactVerifier(new PactVerifierConfig
        {
            ProviderVersion = "1.0.0"
        });

        pactVerifier
            .ServiceProvider("HelloApi", _providerUri)
            .HonoursPactWith("Consumer")
            .PactUri(@"..\..\..\pacts\consumer-helloapi.json") // 契约文件路径
            .Verify();
    }

    [OneTimeTearDown]
    public void Teardown()
    {
        // 停止服务并释放资源，避免端口占用
        _testApp.StopAsync().Wait();
        _testApp.Dispose();
    }
}

3. 关键注意事项

• 端口冲突处理：可以使用动态端口（如http://localhost:0），启动后从_testApp.Urls获取实际绑定的端口，再传递给PactVerifier。
• 环境隔离：测试时可指定测试环境，比如在CreateTestWebApplication中设置builder.Environment.EnvironmentName = "Test"，避免干扰开发环境配置。
• 资源释放：必须在Teardown阶段停止并释放WebApplication实例，防止端口被长期占用。

内容的提问来源于stack exchange，提问作者Imer Muhović