.NET 8 Provider执行Pact契约验证时服务意外终止求助

问题现象 #

运行.NET 8 Provider进行契约验证时，服务会在Verify()执行过程中意外终止，无法获取有效日志定位原因。但如果在代码中添加30秒延迟，且在延迟期间通过Postman访问服务端点，测试就能成功通过。

服务确实运行在指定端口（https://localhost:5066），延迟期间可正常通过Postman访问，但未提前调用时，Verify()过程会直接终止，仅返回错误：

Request Failed - error sending request for url (https://localhost:5066/api/v1/searchEndpoint)

日志末尾仅显示：

DEBUG ThreadId(02) verify_interaction{interaction="a Search request"}: hyper_util::client::legacy::connect::http: connecting to [::1]:5066
DEBUG ThreadId(02) verify_interaction{interaction="a Search request"}: hyper_util::client::legacy::connect::http: connected to [::1]:5066
WARN ThreadId(02) pact_matching::metrics: 

现有代码 #

契约测试类 #

public class ContractTests : IClassFixture<ApiFixture>
{
    private readonly ITestOutputHelper _output;
    private readonly ApiFixture _fixture;
    private readonly Uri _pactBrokerBaseUri = new Uri("<pactBrokerUri>");
    private readonly string _providerName = "provider";
    private readonly string _consumerName = "consumer";

    public ContractTests(ITestOutputHelper outputHelper, ApiFixture fixture)
    {
        _fixture = fixture;
        _output = outputHelper;
    }
    [Fact]
    public async Task EnsureProviderApiHonoursPactWithConsumer()
    {
        // Arrange
        var config = new PactVerifierConfig
        {
            Outputters = new List<Pact.IOutput>
            {
                new XunitOutput(_output)
            },
            LogLevel = PactLogLevel.Debug,
        };
        // Act
        IPactVerifier pactVerifier = new PactVerifier(_providerName, config);
        var _pactVerifier = pactVerifier
            .WithHttpEndpoint(_fixture.ServerUri)
            .WithUriSource(
                new Uri($"{_pactBrokerBaseUri}pacts/provider/{_providerName}/consumer/{_consumerName}/latest"));

        // 延迟用于Postman提前调用端点
        await Task.Delay(TimeSpan.FromSeconds(30));

        // Assert
        _pactVerifier.Verify();
    }
}

API Fixture类 #

public class ApiFixture : IDisposable
{
    private readonly IHost _server;
    public Uri ServerUri { get; }

    public ApiFixture()
    {
        ServerUri = new Uri("https://localhost:5066");
        _server = CreateHostBuilder(ServerUri)
            .Build();
        _server.Start();
    }

    public static IHostBuilder CreateHostBuilder(Uri serverUri) =>
        Host.CreateDefaultBuilder()
            .UseSerilog()
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseUrls(serverUri.ToString());
                webBuilder
                    .UseStartup<TestStartup>();
            });

    public void Dispose()
    {
        _server.Dispose();
    }
}

可能的原因与解决方案 #

1. 服务未完全启动就绪就执行验证 #

_server.Start()是同步方法，但.NET 8的WebHost启动可能存在异步初始化逻辑（比如依赖注入服务初始化、中间件预热），此时端口虽已监听，但请求处理管道尚未完全就绪。Postman的提前调用相当于触发了初始化，后续Pact验证请求就能正常处理。

解决方法：改用异步启动并等待服务完全就绪：
修改ApiFixture构造函数：

public ApiFixture()
{
    ServerUri = new Uri("https://localhost:5066");
    _server = CreateHostBuilder(ServerUri)
        .Build();
    // 异步启动并等待完成
    _server.StartAsync().GetAwaiter().GetResult();
}

2. HTTPS证书信任问题 #

Pact验证客户端可能不信任本地开发HTTPS证书，导致连接建立后请求发送失败。Postman默认信任本地开发证书，因此能正常访问。

解决方法：

• 先确保本地开发HTTPS证书已信任：

dotnet dev-certs https --trust

• 或者在Pact配置中临时禁用证书验证（仅测试环境使用）：

var config = new PactVerifierConfig
{
    Outputters = new List<Pact.IOutput> { new XunitOutput(_output) },
    LogLevel = PactLogLevel.Debug,
    DisableSslCertificateVerification = true
};

3. 服务依赖初始化延迟 #

如果服务启动后需要异步初始化外部依赖（如数据库连接、缓存加载），第一个请求到达时这些操作可能还未完成。Postman的提前调用会触发初始化，后续Pact请求就能正常处理。

解决方法：添加服务就绪检查，等待关键依赖初始化完成：
修改ApiFixture：

public ApiFixture()
{
    ServerUri = new Uri("https://localhost:5066");
    _server = CreateHostBuilder(ServerUri)
        .Build();
    _server.StartAsync().GetAwaiter().GetResult();
    
    // 等待服务健康检查端点就绪
    WaitForServiceReady(ServerUri);
}

private void WaitForServiceReady(Uri serverUri)
{
    var handler = new HttpClientHandler
    {
        ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true
    };
    using var httpClient = new HttpClient(handler);
    
    var maxAttempts = 10;
    var delayMs = 1000;
    for (int i = 0; i < maxAttempts; i++)
    {
        try
        {
            var response = httpClient.GetAsync($"{serverUri}/health").GetAwaiter().GetResult();
            if (response.IsSuccessStatusCode) break;
        }
        catch { }
        Thread.Sleep(delayMs);
    }
}

同时在TestStartup中配置健康检查端点：

public void ConfigureServices(IServiceCollection services)
{
    services.AddHealthChecks();
    // 其他服务配置
}

public void Configure(IApplicationBuilder app)
{
    // 其他中间件配置
    app.UseHealthChecks("/health");
}

4. HTTP版本兼容性问题 #

.NET 8默认使用HTTP/2，但Pact验证客户端可能在HTTP/2下存在兼容性问题，Postman默认使用HTTP/1.1所以能正常访问。

解决方法：强制服务使用HTTP/1.1：
修改ApiFixture的WebHost配置：

public static IHostBuilder CreateHostBuilder(Uri serverUri) =>
    Host.CreateDefaultBuilder()
        .UseSerilog()
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseUrls(serverUri.ToString());
            webBuilder.UseKestrel(options =>
            {
                options.ListenAnyIP(serverUri.Port, listenOptions =>
                {
                    listenOptions.Protocols = HttpProtocols.Http1;
                    listenOptions.UseHttps();
                });
            });
            webBuilder.UseStartup<TestStartup>();
        });

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